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CHAPTER  I 


INTRODUCTION 


1 . 1  PURPOSE 

The  Ada  [Ada  is  a  registered  trademark  of  the  U.S.  Government,  Ada 
Joint  Program  Office]  Programming  Support  Environment  (APSE) 
Interactive  Monitor  (AIM)  User's  Manual  was  written  to  provide  a 
useful  reference  manual  for  the  AIM  regardless  of  the  APSE  in  which  it 
is  to  be  used.  The  AIM  is  under  development  for  the  Naval  Ocean 
Systems  Center  (NOSC),  Contract  N66001-82-C-0440 . 

1 . 2  SCOPE 

The  AIM  User's  Manual  contains  a  glossary  (Chapter  2),  a  description 
of  the  AIM  (Chapter  3),  command  reference  information  (Chapter  4),  AIM 
operating  instructions,  (Chapter  5),  and  a  tutorial  (Appendix  A). 

1.3  ORGANIZATION 

The  AIM  User's  Manual  was  written  to  accommodate  any  APSE  in  which  the 
AIM  is  to  be  used.  Only  Chapter  5  and  the  appendix  containing  the 
tutorial  need  be  changed  for  any  APSE.  Chapter  5  contains  system 
specific  operating  instructions  and  the  tutorial  contain  system 
specific  examples  which  may  require  changes  for  each  APSE.  Chapter  4 
of  the  manual  is  an  AIM  commands  reference  guide.  Chapter  4,  in 
combination  with  the  appendix,  covers  most  aspects  of  the  AIM 
commands . 
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CHAPTER  2 
GLOSSARY 


2 . 1  ACRONYMS 

BNF 

Backus-Naur  Form 

ADE 

Data  Gene:  Corporation's  Ada  Development  Environment 

AIE 

Ada  Integrated  Environment 

AIM 

APSE  Interactive  Monitor 
AIM  CLI 

AIM  Command  Language  Interpreter 

ALS 

Ada  Language  System 

APSE 

Ada  Programming  Support  Environment 

CPC  I 

Computer  Program  Configuration  Item. 

KAPSE 

Kernel  Ada  Programing  Support  Environment 

MAPSE 

Minimum  Ada  Programing  Support  Environment 


GLOSSARY 

ACRONYMS 


NOSC 

Naval  Ocean  Systems  Center 


GLOSSARY 

DEFINITIONS 


2.2  DEFINITIONS 


Ada  Programming  Support  Environment  (APSE) 

The  purpose  of  an  APSE  is  to  support  the  development  and 
maintenance  of  Ada  applications  software  throughout  its  life 
cycle,  with  particular  emphasis  on  software  for  embedded  computer 
applications.  The  principal  features  are  the  database,  the 
interface  and  the  toolset.  It  is  structrued  in  levels: 
level  0:  hardware  and  host  software  as  appropriate 
level  I:  KAPSE 
level  2:  MAPSE 

level  3:  APSE's  which  are  constructed  by  extensions  of  the  MAPSE 
to  provide  fuller  support  for  particular  applications  or 
methodclog ies . 

AIM  Command  Language  Interpreter  (AIM  CLI) 

The  AIM  subsystem  concerned  with  the  interpretation  of  user 
commands.  The  user  commands  include  those  specified  directly  to 
the  AIM  CLI  by  the  user  as  well  as  special  key  sequences  (such  as 
the  SW I TCH_TO_ A I M  key). 

AIM  virtual  terminal 

The  AIM  subsystem  concerned  with  the  manipulation  and 
interrogation  of  display  terminals. 

APSE  Command  Language  Processor  (CLP) 

The  APSE  Command  Language  Processor  is  the  program  within  th^ 
host  APSE  concerned  with  the  interpretation  of  user  commands  at 
the  APSE  level. 

APSE  program 

A  program  that  can  be  executed  in  the  hosting  APSE  and  uses  only 
KAPSE  supplied  services  to  perform  its  function. 

area 

A  set  of  adjacent  character  positions  in  a  visual  display  that 
are  not  necessarily  on  the  same  line. 

3ackus-Naur  Form 

A  context-free  grammer  specification  for  the  syntax  of 
programming  language. 

character 

A  member  of  a  set  of  elements  that  is  used  for  the  organization, 
control,  or  representation  of  data. 
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character  echo 

The  act  of  re- 1 ransrr i  1 1  i ng  a  character  upon  receipt  of  it  back  to 
the  entity  that  originally  transmitted  it. 

character  imaging  device 

A  device  that  gives  a  visual  representation  of  data  in  the  form 
of  graphic  symbols  using  any  technology,  such  as  cathode  ray  tube 
or  printer. 

character  stream 

An  unbounded  sequence  of  ASCII  characters, 
character  string 

A  bounded  sequence  of  ASCII  characters, 
database  file 

A  standard  file  in  the  APSE  database, 
d i sp lay 

The  area  for  visual  presentation  of  data  on  a  character  imaging 
dev  ice. 

display  terminal 

A  data  communications  device  composed  of  a  keyboard  and  a  display 
screen  (usually  a  cathode  ray  tube). 

editing  extent 

The  physical  extent  on  the  display  screen  where  user  editing  of 
character  data  is  to  be  allowed.  Valid  editing  extent  are  the 
display  screen,  a  line  on  the  display,  and  a  field  within  a  line. 

hardcopy  terminal 

A  data  communications  device  composed  of  a  keyboard  and  a 
pr i nter . 

image 

An  image  is  an  analog  of  the  physical  display  device.  The  image 
is  the  entity  that  is  mapped  onto  the  display.  Given  a  number  of 
user  defined  images,  only  one  at  a  time  can  be  mapped  onto  the 
display.  The  other  images  exist  and  are  updated  asynchronously 
but  are  not  mapped  onto  the  display  until  the  user  requests  it. 

input  pad 

An  APSE  database  file  used  to  log  a  particular  window's  input. 
When  a  window's  input  pad  is  active,  all  input  destined  for  the 
window  is  written  to  this  file;  the  logging  begins  when  the  user 
activates  the  pad  and  continues  until  the  pad  is  deactivated. 
The  user  can  directly  deactivate  a  window's  input  pad  via  a 
textual  command,  or  may  indirectly  deactivate  it  by  deleting  the 
window  or  exiting  the  AIM. 
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interface 

(1)  A  shared  boundary.  (2)  the  set  of  data  passed  between  two  or 
more  programs  or  segments  of  programs,  and  the  assumptions  made 
by  each  program  about  how  the  other (s)  operate.  '3)  The  common 
boundary  between  software  modules,  between  hardware  devices,  or 
between  hardware  and  software  modules.  (4)  When  applied  to  a 
module,  that  set  of  assumptions  made  concerning  the  module  by  the 
remaining  program  or  system  in  which  it  appears.  Modules  have 
control,  data,  and  services  interfaces.  An  interface  can  be 
represented  by  means  of  Ada  package  syntax  and  semantics. 

Kernel  Ada  Programming  Support  Environment  (KAPSE) 

That  level  of  an  APSE  which  provides  database  communication  and 
runtime  support  functions  to  enable  the  execution  of  an  Ada 
program  (including  a  MAPSE  tool)  and  which  presents  a 
machine- independent  portability  interface. 

keyboard 

The  keyboard  is  the  physical  input  device. 

line 

A  line  is  a  set  of  adjacent  character  positions  in  a  visual 
display  that  have  the  same  vertical  position. 

Minimum  Ada  Programming  Support  Environment  (MAPSE) 

That  level  of  an  APSE  which  provides  a  minimal  set  of  tools, 
written  in  Ada  and  supported  by  the  KAPSE,  which  are  both 
necessary  and  sufficient  for  the  development  and  continuing 
support  of  Ada  programs. 

output  pad 

An  APSE  database  file  used  to  log  a  particular  window's  output. 
When  a  window's  output  pad  is  active,  all  window  output  destined 
for  the  terminal  is  written  to  this  file;  the  logging  begins  when 
the  user  activates  the  pad  and  continues  until  the  pad  is 
deactivated.  The  user  can  directly  deactivate  a  window's  output 
pad  via  a  textual  command,  or  may  indirectly  deactivate  it  by 
deleting  the  window  or  exiting  the  AIM. 

pipe 

A  logical  connection  between  an  output  file  of  one  program  and  an 
input  file  of  another  program. 

qualified  area 

An  area  on  the  display  screen  that  may  have  restrictions  on  the 
type  of  data  that  may  be  entered  and  whose  boundaries  are 
specified  special  qualifiers.  See  "qualifiers". 
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qual i f iers 

Controls  that  define  what  is  valid  data  that  can  be  entered  in 
specific  areas  on  the  display  screen.  Valid  qualifiers  include: 
graphics,  numerics,  all  input,  no  input  (protected),  etc. 

screen 

The  area  for  visual  presentation  of  data  on  any  type  of  character 
imaging  device,  including  printer  and  cathode  ray  tube  device. 

scroll  mode  terminal 

A  display  terminal  that  presents  data  by  moving  all  the  graphic 
symbols  of  the  screen  in  one  direction  to  make  room  for  new  data. 

Selector 

An  operation  on  an  object  that  returns  a  value  or  attribute  and 
makes  no  alteration  of  the  state,  structure,  or  value  of  the 
obj  ect . 

SW I TCH_TO_A I M  key 

The  keyboard  sequence  that  causes  the  AIM  to  perform  the 
SWITCH  TO  AIM  function. 


task 

An  Ada  program  unit  that  operates  in  parallel  with  other  program 
units . 

terminal 

A  data  communications  device  consisting  of  a  keyboard  and  a 
character  imaging  device. 

Terminal  Capabilities  File 

The  Terminal  Capabilities  File  is  an  APSE  database  file  which 
contains  mappings  from  logical  computer  terminal  characteristics 
to  specific  computer  terminal  characteristics.  The  Terminal 
Capabilities  File  can  contain  information  that  supports  many 
different  terminal  types  and  makes. 

transmit 

To  send  data  as  a  data  stream  for  purposes  of  information 
interchange . 

transmitted  data  stream 

The  stream  of  bit  combinations  sent  by  a  character  imaging  device 
when  it  is  induced  to  transmit  for  purposes  of  information 
interchange . 
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user  terminal 

The  terminal  with  which  a  user  interacts  in  order  to  communicate 
with  an  APSE  program. 

viewport 

A  viewport  is  the  portion  of  the  window  displayed  in  the  image, 
viewport  header 

A  viewport  header  is  a  single  highlighted  line  located  at  the  top 
of  a  viewport . 

window 

A  window  is  an  analog  of  the  APSE  program's  view  of  the  terminal. 
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CHAPTER  3 


AIM  SYSTEM  CAPABILITIES 


3 . 1  PURPOSE 


The  APSE  Interactive  Monitor  (AIM)  is  a  computer  program  that  acts  as 
an  interface  between  a  user  of  the  APSE  and  the  programs  the  user 
executes  in  the  APSE. 

3.2  GENERAL  DESCRIPTIONS 


The  AIM  allows  a  user  to  have  multiple  APSE  programs  executing  while 
keeping  their  interactive  inputs  and  outputs  separate  both  logically 
and  physically.  Facilities  are  provided  by  a  simple  command  language 
to  supplement  or  replace  the  standard  functions  available  through  the 
APSE  user  interface  in  the  area  of  terminal  and  program  control. 

3.3  FUNCTION  PERFORMED 


The  AIM  will  interface  with  page  mode  computer  terminals. 

Page  mode  terminals  transmit  and  receive  characters  one  at  a  time. 
When  a  key  is  pressed  on  the  keyboard,  the  character  corresponding  to 
that  key  is  transmitted.  When  a  character  is  received  by  the 
terminal,  the  character  is  displayed  or  performs  a  simple  function 
such  as  carriage  return  or  line  feed.  Additionally,  cursor  movement 
and  screen  editing  capabilities  such  as  cursor  positioning  and 
character  and/or  line  insertion/deletion  are  provided. 

3.3.1  Images 


An  AIM  user  defines  structures  called  images,  each  of  which  is  an 
analog  of  the  user's  display.  As  such,  the  length  (number  of  lines) 
and  width  (number  of  character  positions)  attributes  of  an  image  are 
identical  to  that  of  the  display.  Note  that  only  characters  will  be 
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Images 


supported;  no  graphic  support  is  provided.  Any  number  of  images  may 
coexist  at  one  time,  and  the  user  selects  which  image  is  "mapped  onto" 
the  display.  Being  "mapped  onto"  means  that  any  changes  to  the 
information  in  an  image  are  immediately  reflected  on  the  display. 
Only  one  image  may  be  mapped  onto  the  display  at  any  given  time. 

3.3.2  Windows 


An  AIM  user  also  defines  structures  called  windows,  a  window  being  the 
analog  of  the  APSE  program's  view  of  the  terminal.  The  terminal 
output  of  the  APSE  program  is  intercepted  by  the  AIM  and  directed  to  a 
structure  called  a  window.  There  is  exactly  one  window  associated 
with  each  APSE  program  executing  directly  under  the  AIM. 

3.3.3  Viewports 


A  window  is  mapped  onto  an  image  through  a  structure  called  a 
viewport.  A  viewport  is  a  rectangular  area  within  an  image.  The 
width  of  a  viewport  is  equal  to  the  width  of  the  image.  The  length  is 
user  determined  but  can  be  no  larger  than  the  image  length  and  no 
smaller  than  two  lines  (This  includes  a  required  line  for  the  viewport 
header).  As  many  viewports  can  be  defined  as  will  fit  on  any  given 
image.  The  user  defines  the  viewports  by  creating  associations 
between  images  and  windows  and  defining  the  relationships  between  them 
(position  and  length).  Viewports  on  the  same  image  are 
non- intersect ing .  Horizontal  partitioning  is  supported;  vertical 
partitioning  is  not.  The  space  on  an  image  that  does  not  contain  a 
viewport  is  considered  dead  space  and  no  information  is  mapped  onto 
it.  A  window  may  be  associated  with  more  than  one  viewport  at  the 
same  time,  but  a  specific  window  may  only  be  associated  with  a 
specific  image  once. 

3. 3. 3.1  Viewport  Header  - 

Each  viewport  will  have  an  identification  line  associated  with  it 
called  a  viewport  header.  The  viewport  header  occupies  one  line  at 
the  top  of  each  viewport  (included  as  part  of  the  viewport  length). 

The  AIM  provides  viewport  information  in  the  form  of  a  header  line. 
The  viewport  header  fields  follow; 
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Descript  ion 

Pcs  i  t  ion 

Length 

What  to  expect 

1 

1 

blank 

Image  Name . . 

. 2- 

-15 

14 

Ada  identifier 

16 

1 

blank 

Window  Name . . 

.  ..17- 

-30 

14 

Ada  identifier 

31 

1 

blank 

Program  Status . .  . 

_ 32- 

-55 

24 

string 

56 

1 

blank 

More  Window  Output... 

_ 57- 

-70 

14 

string 

71 

1 

blank 

Mode  Flags . 

_ 72- 

-80 

9 

described  below 

The  Mode  Flags  are  as  follows: 

a.  Suspended  program  output  (S) 

b.  Pause  on  full  window  (F) 

c .  I nput  Pad  ( I ) 

d.  Output  pad  (0) 

e.  Suspend  output  on  SWITCH_TO_AIM  command  (A) 


Note : 

a.  Text  too  large  for  its  appropriate  field  will  be  truncated  on  the 
right  in  order  to  fit  within  the  field  boundaries. 

b.  The  viewport  headers  will  be  emphasized  in  the  terminal  display 
(whether  that  be  highlighted,  inverse  video,  underlined,  etc.)  if 
the  terminal  can  support  such  emphasis. 


3.3.4  Pre-Defined  Images 


Two  predefined  images  (named  AIM  and  MAIN)  are  created  when  the  AIM 
program  is  invoked. 

3. 3. 4.1  AIM  - 

The  AIM  image  is  a  predefined  image  associated  (through  a  viewport) 
with  a  predefined  window  also  called  AIM.  The  AIM  image  and  the  AIM 
window  cannot  be  deleted,  nor  can  they  be  disassociated  since  the  AIM 
image  communicates  directly  with  the  AIM  command  interpreter  to 
perform  the  functions  associated  with  the  AIM  processing.  A  special 
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key  sequence  is  provided  to  switch  a  user  directly  to  this  image. 

3  .  3 . 4 . 2  MAIN  - 

The  MAIN  image  is  a  predefined  image  associated  (through  a  viewport/ 
with  a  single  predefined  window  also  called  MAIN.  An  APSE  program  is 
started  and  associated  with  this  window  upon  invoking  the  AIM.  This 
APSE  program  is  normally  the  APSE  command  language  processor.  The 
MAIN  image  is  the  one  initially  connected  to  the  user's  terminal.  The 
MAIN  image  and  window  are  exactly  like  all  others  from  this  point  on. 
They  can  be  deleted  or  reassociated  at  any  time. 

3.3.5  Pads 


An  AIM  user  can  at  any  time  request  the  activation  of 
pad,  output  pad,  or  both;  each  activation  of  a  pad 
database  file.  A  pad  may  be  activated  or  deactivated 
separately.  A  summary  of  pad  functionality  follows: 


a  window's  input 
creates  a  unique 
for  each  window 


a.  From  activation  until  the  window  is  deleted  or  the  user 
deactivates  the  pad ( s )  associated  with  the  window,  a  pad(s)  log 
ail  session  input  and/or  output  activity  for  a  particular  window. 

b.  Deleting  a  window  which  has  a(n)  active  pad(s)  causes  the 
associated  database  file(s)  to  be  closed. 

c.  Deactivating  a  pad(s)  associated  with  a  window  results  in  the 
associated  database  file(s)  being  closed. 

d.  Cnee  a  pad  has  been  closed,  activating  the  pad  again  for  the  same 
window  causes  the  creation  of  a  new  file. 

e.  When  the  AIM  EXIT  or  ABORT  command  is  used,  all  active  pad(s)  will 
be  closed. 

f.  Pad  file(s)  which  have  been  closed  are  accessible  (environmentally 
dependent)  by  other  APSE  tools  at  a  later  date. 


3.3.6  Terminal  Capabilities  File 


The  Terminal  Capabilities  file  (TCF)  is  an  APSE  database  file 
containing  mappings  from  logical  computer  terminal  characteristics  to 
specific  computer  terminal  characteristics.  This  file  contains 
information  that  describes  the  common  terminal  functions  in  terms  of 
device-specific  character  sequences.  An  initial  set  of  terminal 
capabilities  is  provided  with  the  AIM  defining  the  capabilities  of 
terminals  produced  by  some  major  manufacturers.  Capabilities  of 
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terminals  not  defined  in  the  terminal  capabilities  file  may  be  added 
by  a  system  manager. 

The  terminal  capabilities  file  contains  one  entry  for  each  '  different 
terminal  type.  Each  entry  contains  the  terminal  specific  character 
codes  and/or  sequences  needed  to  support  all  the  required  capabilities 
of  the  AIM  virtual  terminal. 
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CHAPTER  4 


AIM  COMMANDS 


The  first  section  of  this  chapter  covers  command  variations.  Within 
Command  Variation,  the  areas  of  command  recognition,  command 
completion,  parameter  prompting,  and  implicit  help  are  discussed. 
Command  Variation  is  followed  by  sections  describing  the  text  commands 
and  keystroke  commands  respectively.  Each  option  of  a  Textual  Command 
is  explained  separately.  For  example,  the  CREATE  command  has  two 
different  options  (WINDOW  or  IMAGE)  and  each  of  these  is  explained  in 
its  own  section. 
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4.1  COMMAND  VARIATION 

The  AIM  command  language  was  designed  to  be  very  flexible.  Since  the 
language  will  be  used  both  interactively  (input  from  the  terminal)  and 
in  "batch”  mode  (input  from  a  command  script),  a  language  format  that 
was  easy  to  type  and  yet  easy  to  read  and  understand  was  desired. 
Therefore,  AIM  commands  may  have  two  syntax  forms:  an  Ada- like  form 
or  short  form.  Either  form  of  the  command  may  be  used  interchangeably 
during  an  AIM  session.  The  AIM  command  interpreter  recognizes  minimal 
strings  of  an  AIM  command;  for  example,  instead  of  typing  "CREATE", 
the  user  may  simply  type  "CR"  which  uniquely  identifies  the  CREATE 
command . 

The  following  sessions  demonstrate  the  various  possibilities  for 
command  input  including  command  completion,  command  recognition, 
parameter  prompting,  and  implicit  help.  These  variations  are  NOT 
shown  for  every  command  but  they  do  apply  to  all  commands.  The 
variations  shown  can  be  used  at  anytime  when  entering  AIM  commands. 

Session  Assumptions: 

1.  Data  General  Corporation's  Ada  Development  Environment 

2.  a  Page  terminal 

3.  terminal  display  with  24  lines  and  80  character  columns 


For 

in 


2. 


the  reader's  convenience 
the  presentation  of  this 

ALL  user  responses  will 
screen 

the  affect  of  executing 
next  screen  relative  to 

the  comments  below  each 

a.  the  affect  of  execut 

b.  the  contents  of  the 

c.  the  new  AIM  command 


,  the  following  conventions  will  be  used 
sess ion : 

appear  on  the  last  nonblank  line  of  the 

a  user's  command  will  be  presented  in  the 
when  the  command  was  issued 

screen  will  explain: 

ing  the  previous  AIM  command 

current  screen 

issued  at  the  bottom  of  the  present  screen 
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The  default  key  sequences  that  exist  when  the  AIM  is 
ASCII  Page  Mode  Terminal  are  as  follows: 

DEFAULT  KEYSTROKES 


ABORT_SCR  I PT . FI 

CLEAR_WI  NDOW . F2 

NEXT_IMAGE . F3 

NEXT_PAGE . F4 

NEXT_V  I EWPORT . F  5 

PRE  V I  OUS_  I  MAGE . F6 

PREV I  OUS_V  I  EWPORT . F  7 

RED  I  SPLAY_SCREEN . F8 

RETURN_TO_PRE  V I  OUS_  I  MAGE . F9 

SWITCH  TO  AIM . F10 


where  "F#"  represents  a  function  key. 


AIM  COMMANDS 
COMMAND  VARIATION 

invoked  from  a 
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4.1.1  COMMAND  RECOGNITION 

The  AIM  provides  four  forms  for  commands: 

a.  Long  Form  (named  parameter  association) 

b.  Abbreviated  Long  form  (mixed) 

c.  Short  Form  (positional) 

d.  Abbreviated  Short  form 

The  following  session  demonstrates  each  of  these  forms.  The  first 
screen  shows  a  sample.  It  is  followed  by  an  actual  AIM  session. 

SAMPLE 

AIM  ATM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WIN1  --  Long  Form 

--  is  identical  to 

AIM>  CR  OBJ ECT_TYPE  =>  WINDOW  W I NDCW_NAME  =>  WIN1  --  Abbreviated  Long  Forr 
--  is  identical  to 

AIM>  CREATE  WINDOW  WIN1  --  Short  Form 

—  is  identical  to 

AIM>  CR  W  WIN1  --  Abbreviated  Short  Forr 


BOTTOM-OF-SCREEN 


The  AIM  session  follows 


AIM  COMMANDS 
COMMAND  RECOGNITION 


INVOKE  AIM  FROM  APSE 

- )  AIM 


BOTTOM-OF-SCREEN 


Comments : 

Command:  AIM  -  invoke  the  AIM  from  the  APSE. 


i 

l 
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SWITCH  TO  AIM  IMAGE 

MAIN  MAIN  FRCH: 016  Running  A F 

AOS/vs  CLI  REV  05.01.00.00  9-APR-85  13:26:43  {  F 1 0  } 


BOTTOM-OF-SCREEN 


Comments:  The  AIM  initializes  the  current  image  to  be  MAIN.  To  enter  AIM 
textual  commands  the  user  must  communicate  through  the  AIM  image  to  the  AIM 
command  interpreter. 

Command:  { F 1 0 }  -  Set  the  current  image  to  be  the  AIM  image  by  using  the 
SW I TCH_TO_A I M  keystroke. 
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. 

I 

P  LONG  FORM 

AIM  AIM  AIM  CLI  Running  AF 

_  AIM>  CREATE  OBJECT  TYPE  =>  WINDOW  WINDOW  NAME  =>  WIN1 


BOTTOM-OF-SCREEN 


Comments:  The  cursor  is  now  at  the  top  of  the  AIM  image.  AIM  commands  can 
only  be  entered  from  the  AIM  image.  Control  has  been  passed  to  the  AIM  CLI 
executing  in  the  AIM  window. 

Command:  CREATE  OBJECT  TYPE  =>  WINDOW  WINDOW  NAME  =>  WIN1  -  Create  a 
window  in  the  AIM  environment  named  WIN1. 
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ABBREVIATED  LONG  FORM 


AIM  AIM  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WINl 
AIM>  CR  OBJECT  TYPE  =>  WINDOW  WINDOW  NAME  =>  WIN2 


BOTTOM-OF-SCREEN 


Comments:  Show  long  (named)  form  of  create  command. 

Command:  CR  OBJECT  TYPE  =>  WINDOW  WINDOW  NAME  =>  WIN2  -  Create  a  window  in 

the  AIM  environment  named  WIN2. 
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SHORT  FORM 

AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WIN1 
AIM>  CR  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WIN2 
AIM>  CREATE  WINDOW  WIN3 

I 

I 

I 

f 

BOTTOM- 0  F- SCREEN 


Comments:  The  "CR"  followed  by  named  parameters  is  the  abbreviated  long 

form  of’  create  command. 

Command:  CREATE  WINDOW  WIN3  -  Create  the  window  WIN3. 


4-9 


AIM  COMMANDS 
COMMAND  RECOGNITION 


ABBREVIATED  FORM 

~AIM  AIM  AIM  CLI  Running 

AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WIN1 
AIM>  CR  OBJECT_TYPE  =>  WINDOW  WINDOW_NAME  =>  WIN2 
AIM>  CREATE  WINDOW  WIN3 
AIM>  CR  W  WIN4 


_ BOTTOM-OF-SCREEN _ 

Comments:  Show  abbreviated  short  (positional)  form  of  create  command 

Command:  CR  W  WIN4  -  Create  the  window  WIN4. 


AF 
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ENTER  EXIT  COMMAND 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WIN1 
AIM>  CR  OBJ ECT_TYPE  =>  WINDOW  WINDOW_NAME  =>  WIN2 
AIM>  CREATE  WINDOW  WIN3 
AIM>  CR  W  WIN4 
AIM>  EXIT 


BOTTOM-OF- SCREEN 


Comments:  Show  the  minimal  form  of  create  command.  All  commands  can  be 

abbreviated. 

Command:  EXIT  -  Enter  the  exit  command. 
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EXIT 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WIN1 
AIM>  CR  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WIN2 
AIM>  CREATE  WINDOW  WIN3 
AIM>  CR  W  WIN4 
AIM>  EXIT 
-) 


BOTTOM-OF- SCREEN 


Comments:  Exit  the  AIM  environment  and  return  to  the  ADE. 

Command:  None. 
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4.1.2  COMMAND  COMPLETION 

Command  Completion  is  provided  by  the  AIM.  The  command  interpreter  will 
complete  any  recognized  keyword.  This  session  demonstrates  the  command 
completion  facility.  The  first  screen  is  a  sample.  It  is  followed  by  an 
actual  AIM  session. 


SAMPLE 

AIM  AIM  CLI  Running  AF 

--  User  enters  abbreviated  command 
followed  by  a  carriage  return. 
--  AIM  completes  the  command 


and 


AIM>  CREATE  I  --  User  enters  abbreviated  object 

followed  by  a  carriage  return. 

AIM>  CREATE  IMAGE  --  AIM  completes  the  object 


BOTTOM-OF-SCREEN 


The  AIM  session  follows. 


AIM 

a:m>  cr 
a:m>  create 
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INVOKE  AIM  FROM  APSE 

-)  AIM 


BOTTOM-OF-SCREEN 


Comments : 

Command:  AIM  -  invoke  the  AIM  from  the  APSE. 
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MAIN  MAIN 

AOS/VS  CLI  REV  05.01.00.00 


SWITCH  TO  AIM  IMAGE 
FRCH : 0 16  Running 

9- APR-8  5  13:26:43 


{ F 1 0  } 


AF 


BOTTOM-OF-SCREEN 


Comments:  The  AIM  initializes  the  current  image  to  be  MAIN.  To  enter  AIM 
textual  commands  the  user  must  communicate  through  the  AIM  image  to  the  AIM 
command  interpreter. 

Command:  { F 1 0 }  -  Set  the  current  image  to  be  the  AIM  image  by  using  the 
SW I TCH_TO_A I M  keystroke. 
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COMMAND  COMPLETION 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CR 


BOTTOM-OF-SCREEN 


Comments:  The  cursor  is  now  at  the  top  of  the  AIM  image.  AIM  commands  car. 
only  be  entered  from  the  AIM  image.  Control  has  been  passed  to  the  AIM  CL  I 
executing  in  the  AIM  window. 

Command:  CR  -  enter  enough  letters  to  uniquely  identify  the  CREATE 
command. 
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COMMAND  COMPLETION 

AIM  ATM  AIM  CL I  Running  AF 

AIM>  CREATE  I 


_ BOTTOM- OF -SCREES _ 

Comments:  The  AIM  CLI  completes  the  command  when  a  carriage  return  is 

entered;  "CR"  is  now  "CREATE". 

Command:  CREATE  I  -  enter  enough  characters  to  uniquely  identify  image. 
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COMMAND  COMPLETION 

AIM  AlM  AIM  CLI  Running 

AIM>  CREATE  IMAGE  IMAGE  1 


BOTTOM-OF- SCREEN 


Comments:  The  AIM  CLI  completes  the  object  when  a  carriage 

entered;  "I"  is  now  "IMAGE". 

Command:  CREATE  IMAGE  IMAGE_1  -  Enter  the  image  name. 


AF 


return  is 
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A 

COMMAND 


ENTER  EXIT  COMMAND 


AIM  AIM  AIM  CLI  Runn i ng 

AIM>  CREATE  IMAGE  IMAGE_1 
AIM>  EXIT 


BOTTOM-OF-SCREEN 


Comments : 
Command: 


The  image  name 
EXIT  -  Exit  the 


has  been  entered. 
AIM. 


tm  roMwiMnc 
COMPLETION 


AF 
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EXIT 


AIM  AIM  AIM  CLI  Running 

AIM>  CREATE  IMAGE  IMAGE_1 
AIM>  EXIT 
-) 


BOTTOM-OF-SCREEN 


Comments:  Exit  the  AIM. 

Command:  None. 
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4.1.3  PARAMETER  PROMPTING 

The  AIM  will  prompt  for  parameters  missing  from  a  recognized  command. 


SAMPLE 


AIM  AIM  AIM  CLI 

AIM>  CREATE 
_OBJECT_TYPE  *> 

One  of  the  following  tokens  expected: 
IMAGE  WINDOW 


Running  AF 

--  User  Input 
--  System  Response  is  to 
prompt  for  object  type. 


OBJECT_TYPEAIM>  IMAGE 
'IMAGE  NAME  =  >  IM1 


User  Inputs  object  type 
System  Response  is  to 
prompt  for  the  name. 


BOTTOM- OF - SCREEN 


The  AIM  session  follows: 


AIM  COMMANDS 
PARAMETER  PROMPTING 


INVOKE  AIM  FROM  APSE 

)  AIM 


BOTTOM-OF-SCREEN 


Comments : 

Command:  AIM  -  invoke  the  AIM  from  the  APSE. 
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SWITCH  TO  AIM  IMAGE 

MAIN  MAIN  FRCH: 016  Running  AF 

AOS/VS  CLI  REV  05.01.00.00  9-APR-85  13:26:43  { F10 } 


BOTTOM-OF-SCREEN 


Comments:  The  AIM  initializes  the  current  image  to  be  MAIN.  To  enter  AIM 
textual  commands  the  user  must  communicate  through  the  AIM  image  to  the  AIM 
command  interpreter. 

Command:  {F10}  -  Set  the  current  image  to  be  the  AIM  image  by  using  the 
SW I TCH_TO_A I M  keystroke. 
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PARAMETER  PROMPTING 

AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE 


BOTTOM-OF-SCREEN 


Comments:  The  cursor  is  now  at  the  top  of  the  AIM  image.  AIM  commands  car. 
only  be  entered  from  the  AIM  image.  Control  has  been  passed  to  the  AIM  CLI 
executing  in  the  AIM  window. 

Command:  CREATE  -  Enter  the  create  command. 
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PARAMETER  PROMPTING 

AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE 
OBJECT  TYPE  =>  IMAGE 


_ BOTTOM-OF-SCREEN _ 

Comments:  The  AIM  prompt  appears  and  the  AIM  header  is  at  the  top  of  the 
screen.  Enter  the  create  command  and  hit  return  to  be  prompted. 

Command:  IMAGE  -  Create  an  image. 
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PARAMETER  PROMPTING 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE 
_OBJECT_TYPE  *>  IMAGE 
IMAGE  NAME  =*>  IM1 


BOTTOM-OF-SCREEN 


Comments:  The  user  is  now  prompted  to  enter  an  object  type.  Enter  either 

window  or  image. 

Command:  IMAGE  NAME  =>  IM1 
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ENTER  EXIT  COMMAND 

“AIM  aTm  AIM  CLI  Running  AF 

AIM>  CREATE 

_OBJECT_TYPE  =>  IMAGE 

_IMAGE_NAME  =>  IMl 

AIM>  EXIT 


_ BOTTOM-OF-SCREEN _ 

Comments:  The  user  is  now  prompted  for  the  image  name.  The  image  IMl  is 

created. 

Command:  EXIT 
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EXIT 


AIM  AIM  AIM  CLI  Running 

AIM>  CREATE 
OBJECT_TYPE  =>  IMAGE 
~IMAGE_NAME  *>  IM1 
AIM>  EXIT 
-) 


BOTTOM - OF - SCREEN 


Comments:  Exit  the  AIM. 

Command:  None. 
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4.1.4  IMPLICIT  HELP 


The 

n  ■?  it 


AIM  provides  an  implicit  help  function  which  is  requested  by  "?".  The 
may  appear  anywhere  within  an  AIM  command.  The  following  is  a 
demonstration  of  the  Implicit  Help  function.  The  first  screen  is  a  sample. 
It  is  followed  by  an  actual  AIM  session. 


SAMPLE 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  D? 

One  of  the  following  tokens  expected: 

DEFINE  DELETE 

DISASSOCIATE 

AIM>  D  --  AIM  Prompts 


AIM>  DEL  ?  --  User  enters  "EL"  after  the 

One  of  the  following  tokens  expected:  "D" 

IMAGE  WINDOW 

OBJECT_TYPE 

AIM>  DEL  --  Delete  Image  or  Window 


AIM>  DEL  I  ? 

IMAGE_NAME 

AIM>  DEL  I  --  Image  name  requested 


BOTTOM- OF - SCREEN 


The  AIM  session  follows. 


AIM  COMMANDS 
IMPLICIT  HELP 


INVOKE  AIM  FROM  APSE 

1  AIM 


BOTTOM-OF- SCREEN 


Comments: 

Command:  AIM  -  invoke  the  AIM  from  the  APSE. 
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MAIN  MAIN 

AOS/VS  CLI  REV  05.01.00.00 


SWITCH  TO  AIM  IMAGE 
FRCH :  0 1 6  Runn  ing. 

9-APR-8 5  13:26:43  { F10 } 


AF 


BOTTOM-OF- SCREEN 


Comments:  The  AIM  initializes  the  current  image  to  be  MAIN.  To  enter  AIM 
textual  commands  the  user  must  communicate  through  the  AIM  image  to  the  AIM 
command  interpreter. 

Command:  { FI 0 }  -  Set  the  current  image  to  be  the  AIM  image  by  using  the 
SW I TCH_TO_ A I M  keystroke. 
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IMPLICIT  HELP 

AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  IMAGE  IM1 


BOTTOM-OF-SCREEN 


Comments:  The  cursor  is  now  at  the  top  of  the  AIM  image.  AIM  commands  car. 
only  be  entered  from  the  AIM  image.  Control  has  been  passed  to  the  AIM  CLI 
executing  in  the  AIM  window. 

Command:  CREATE  IMAGE  IMl  -  Create  the  image,  IM_1 
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IMPLICIT  HELP 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  IMAGE  I Ml 
AIM>  D? 


_ BOTTOM-OF - SCREEN _ 

Comments:  Create  an  image  to  delete  later  in  the  session. 

Command:  D?  -  see  what  commands  start  with  a  "D" 
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IMPLICIT  HELP 

AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  IMAGE  IMl 
AIM>  D? 

One  of  the  following  tokens  expected: 

DELETE  DEFINE 

DISASSOCIATE 

AIM>  DEL  ? 


BOTTOM-OF-SCREEN 


Comments:  The  user  enters  a  single  valid  character  and  requests  help. 

Command:  EL  ? 
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i  — 

I 
I 


IMPLICIT  HELP 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  IMAGE  I Ml 
AIM>  D? 

One  of  the  following  tokens  expected: 

DEFINE  DELETE 

DISASSOCIATE 

AIM>  DEL  ? 

One  of  the  following  tokens  expected:  One  cf  the  following: 

IMAGE  WINDOW 

03JECT_TYPE 

AIM>  DEL  I  ? 


BOTTOM-OF-SCREEN 


Comments:  The  commands  that  start  with  a  "D"  are  listed.  Enter  enough 
cnaracters  to  uniquely  identify  the  DELETE  command  and  then  request  help  on 
i  t . 

Command:  EL  I  ?  Delete  an  image 
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IMPLICIT  HELP 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  IMAGE  IMl 
AIM>  D? 

One  of  the  following  tokens  expected: 

DEFINE  DELETE 

DISASSOCIATE 

AIM>  DEL  ? 

One  of  the  following  tokens  expected: 

IMAGE  WINDOW 

OBJECT_TYPE 

AIM>  DEL  I  ? 

One  of  the  following  tokens  expected: 

IMAGE_NAME  IDENTIFIER 

AIM>  DEL  I  IMl  N 


BOTTOM-OF-SCREEN 


Comments:  The  DELETE  command  was  recognized.  The  user  can  delete  an  image 
or  a  window.  The  user  responds  by  indicating  the  minimum  number  of 
characters  for  an  image. 

Command:  IMl  -  Delete  the  image  created  earlier. 
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ENTER  EXIT  COMMAND 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  IMAGE  IM1 
AIM>  D? 


One  of  the 

following  tokens 

expected : 

DEFINE 

DELETE 

DISASSOCIATE 

AIM>  DEL  ? 
One  of  the 

following  tokens 

expected : 

IMAGE 

WINDOW 

OBJECT  TYPE 

AIM>  DEL  I 

7 

One  of  the 

following  tokens 

expected : 

IMAGE  NAME 

I  DENT IF 

IER 

AIM>  DEL  I 

IM1 

AIM>  EXIT 

BOTTOM-OF-SCREEN 


Comments:  The  AIM  CLI  responds  with  the  images  that  can  be  deleted.  The 

user  deletes  the  image  created  earlier. 


Command:  EXIT 


Exit  the  AIM 
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EXIT 


AIM  AIM  Running  AF 

AIM>  CREATE  IMAGE  I Ml 
AIM>  D? 

One  of  the  following  tokens  expected: 

DEFINE  DELETE 

DISASSOCIATE 

AIM>  DEL  ? 

One  of  the  following  tokens  expected: 

IMAGE  WINDOW 

OBJECT_TYPE 

AIM>  DEL  I  ? 

One  of  the  following  tokens  expected: 

IMAGE_NAME  IDENTIFIER 

AIM>  DEL  I  IM1 
AIM>  EXIT 
-) 


BOTTOM- OF- SCREEN 


Comments:  Exit  the  AIM. 


Command:  None. 
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4 . 2  TEXTUAL  COMMANDS 
4.2.1  Introduction 

The  AIM  command  language  was  designed  to  provide  the  user  with  a 
robust  command  set  that  is  flexible  and  easy  to  use.  These  goals  have 
been  accomplished  by  allowing  the  user  to  specify  a  textual  command  in 
one  of  three  different  forms: 

1.  a  full  blown  Ada-like  syntax 

2.  a  more  terse  abbreviated  syntax 

3.  any  mixture  of  the  above  two  formats 

For  example,  to  create  a  new  image  called  IM_1  the  user  has  various 
choices: 

1.  CREATE  OBJECT_TYPE  ==>  IMAGE  I  MAG  E_  NAME  =>  IM_1 

2.  CREATE  IMAGE  IMAGE_NAME  =>  IM_i 

3.  CR  IMAGE  IMAGE_NAME  =>  IM_1 

4.  CREATE  OBJECT_TYPE  =>  IMAGE  IM_1 

5.  CR  OBJECT_TYPE  =>  IMAGE  IM_1 

6.  CR  I  IM  1 


4. 2. 1.1  Command  Parameters 

The  majority  of  the  AIM  textual  commands  have  at  least  one  formal 
parameter.  The  AIM  supports  only  positional  parameter  association  for 
its  commands.  The  actual  command  parameters  must  be  spec i f ied  in  the 
exact  order  of  their  formal  parameter  counterparts ;  however,  the 
spec i f icat ion  of  the  formal  parameter  names  is  optional. 

In  the  spirit  of  overloading  procedures  in  Ada,  where  applicable,  AIM 
textual  commands  are  overloaded  by  their  first  parameter.  Typically  a 
command's  first  parameter  represents  an  object  in  the  AIM  environment. 
For  example,  the  CREATE  command  can  be  used  to  create  one  of  two  AIM 
environmental  objects,  either  a  window  or  an  image. 

Note :  For  clarity  and  ease  of  reference,  every  AIM  command  that  has 
an  overloaded  first  parameter  will  be  presented  separately  according 
to  the  alternate  values  of  the  command's  first  parameter.  For 
instance,  the  CREATE  command  is  qualified  and  explained  as  the  CREATE 
IMAGE  and  CREATE  WINDOW  commands,  where  "CREATE  IMAGE  command"  means 
the  AIM  CREATE  command  with  "IMAGE"  as  its  first  parameter. 
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4. 2. 1.2  Command  Description  Format 

Section  4.2  presents  a  thorough  description  of  all  the  textual 
commands  supported  by  the  AIM.  Where  applicable,  the  following 
information  is  provided  for  each  AIM  textual  command: 

1 .  Command  Name 

2.  Functional  Description 

3.  Command  Syntax 

4.  Command  Parameters 

5.  Examples 

6.  Errors 


Notation:  The  asterisk  ("*")  in  the  command  format  description 
denotes  that  all  characters  after  the  are  optional.  Angle 
brackets  ("<  >")  enclose  required  formal  parameters. 
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4.2.2  ABORT_AIM 

4. 2. 2.1  Functional  Description 

The  ABORT_AIM  command  terminates  all  processes  running  under  the  AIM 
and  exits  from  the  AIM  program.  All  active  subordinate  APSE  processes 
are  terminated  without  warning. 

4. 2. 2. 2  Syntax 
AB*ORT 

<  4 

4. 2. 2. 3  Command  Parameters 
None . 

4. 2. 2. 4  Examples 

4. 2. 2. 4.1  Long  Form 

AIM>  ABORT_AIM 

Terminate  all  processes  running  under  the  AIM  and  exit  from  the 
AIM  program. 

4 . 2 . 2 . 4 . 2  Mixed 
Not  applicable. 

4. 2. 2. 4. 3  Short  Form 
AIM>  AB 

Terminate  all  processes  running  under  the  AIM  and  exit  from  the 
AIM  program. 

4. 2. 2. 5  Errors 

The  semantic  errors  associated  with  this  command  include: 


None 
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4.2.3  ASSOCIATE 

4. 2. 3.1  Functional  Description 

The  ASSOCIATE  command  maps  a  specified  portion  of  a  window  onto  an 
image.  Assuming  that  n  =  <length>  and  p  *  <position>  the  ASSOCIATE 
command  maps  the  last  n  lines  of  the  specified  window  onto  the  given 
image  starting  at  the  pth  line  of  the  image.  For  example, 

ASSOC  WIN_1  IM_i  13  12 

will  map  the  last  12  lines  of  WIN_1  onto  lines  13.. 24  of  IM_1.  This 
forms  an  abstract  association  between  WIN_1  and  IM_1  by  creating  a 
viewport  (lines  13  thru  24)  onto  which  the  last  12  lines  of  WIN_1  are 
mapped.  This  viewport  partitions  the  image  vertically,  and  its  width 
is  equal  to  the  width  of  the  image. 

Note :  A  window  may  be  associated  with  more  than  one  image  at  the  same 
time;  however,  a  specific  window  may  only  be  associated  with  a 
specific  image  once. 

4.2. 3.2  Syntax 


AS*SCCI ATE  WINDOW  NAME  =>  <window  name> 


IMAGE  NAME 

=  >  <  image  name> 

TOP 

=>  <position> 

LENGTH 

=>  <length> 

4. 2. 3. 3  Command  Parameters 


1.  WINDOW_NAME  =>  <window  name> 

Specifies  the  window  whose  last  <length>  lines  are  to  be 
mapped  onto  the  specified  image. 

2.  IMAGE_NAME  =>  < image  name> 

Specifies  the  image  onto  which  a  portion  of  the  given 
window  will  be  mapped. 

3.  TOP  *>  <position> 

Specifies  the  starting  position  for  the  association 
relative  to  the  top  of  the  specified  image. 

4.  LENGTH  =>  <length> 

Specifies  the  length  of  the  viewport  used  for  the  requested 
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association.  In  addition  to  the  viewport  header,  at  least 
one  line  of  a  window  must  be  displayed  in  a  viewport; 
therefore,  the  minimum  length  allowable  is  2. 

4. 2. 3. 4  Examples 

4.2. 3.4.1  Long  Form 

AIM>  ASSOCIATE  W I NDOW_NAME  =  >  W I  N_  1  IMAGE_NAME  =  > IM_1  TOP=>i  LENGTH=>24 

Associate  the  entire  contents  of  window  WIN_1  with  the  image 
IM_1 . 

4 . 2 . 3 . 4 . 2  Mixed 

AIM>  ASSOC  WIN_2  IMAGE_NAME  =>  IM_2  1  LENGTH  =  >  8 

Associate  the  last  8  lines  of  window  WIN_2  with  the  first  8 
lines  of  image  IM_1. 

4. 2. 3. 4. 3  Short  Form 
AIM>  AS  WIN_3  IM_3  9  8 

Associate  the  last  8  lines  of  window  WIN_3  with  lines  9  thru  16 
of  image  IM_1. 

4 . 2 . 3 . 5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>,  does  NOT  exist 
(i.e.--no  window  of  that  name  has  been  created) 

2.  "Image  < image  name>  does  not  exist" 

The  specified  image  name,  <image  name>,  does  NOT  exist 
(i.e.--no  image  of  that  name  has  been  created) 

3.  "Invalid  length":  <length> 

The  specified  viewport  length  was  either  out  of  range, 
non-numeric,  or  too  long  to  ensure  non- intersect ing  viewports 
of  the  given  image 

4.  "Invalid  top  line":  <top_line> 

The  specified  top  line  for  starting  the  viewport  was  either 
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out  of  range,  or  non-numeric 

5.  "Association  between  specified  window  and  image  already  exists" 

The  specified  window  is  currently  associated  with  <image  name> 
and  the  AIM  prohibits  multiple  associations  between  the  same 
window  and  image 
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4.2.4  CREATE  IMAGE 

4. 2. 4.1  Functional  Description 

The  CREATE  IMAGE  command  allows  the  AIM  user  to  create  a  new  image  in 
the  AIM  environment.  A  newly  created  image  will  be  alphabetically 
entered  into  the  existing  image  list. 

Note ;  There  is  no  explicit  limit  to  the  number  of  images  that  can  be 
created  during  an  AIM  session. 

4 . 2 . 4 . 2  Syntax 


CR*EATE  OBJECT_TYPE  =>  I *MAGE , 

IMAGE_NAME  =  >  < image  name> 


4. 2. 4. 3  Command  Parameters 

1.  OBJECT_TYPE  =>  I *MAGE 

Specifies  that  a  new  image  is  to  be  created  in  the  AIM 
env i ronment . 

2.  IMAGE_NAME  =>  < image  name> 

Specifies  the  name  of  a  new  image  to  be  created. 

4. 2. 4. 4  Examples 

4. 2. 4. 4.1  Long  Form 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IM_1 
Create  an  AIM  image  named  IM_1. 

4 . 2 . 4 . 4 . 2  Mixed 

AIM>  CREATE  IMAGE  IMAGE_NAME  =>  IM_2 
Create  an  AIM  image  named  IM_2. 

4. 2. 4. 4. 3  Short  Form 
AIM>  CR  I  IM_3 

Create  an  AIM  image  named  IM_3. 


4-45 


AIM  COMMANDS 
CREATE  IMAGE 


4. 2. 4. 5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Image  name,  < image_name> ,  already  in  use" 

The  specified  image  name  already  exists  in  the  AIM  environment 

2.  "Identifier  name  is  too  long" 

The  specified  image  name  was  longer  than  20  characters 
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4.2.5  CREATE  WINDOW 

4.2. 5.1  Functional  Description 

The  CREATE  WINDOW  command  allows  the  AIM  user  to  create  a  new  window 
in  the  AIM  environment.  A  newly  created  image  will  be  alphabetically 
entered  into  the  existing  image  list. 

Note :  There  is  no  explicit  limit  to  the  number  of  windows  that  can  be 

created  during  an  AIM  session. 

The  default  values  for  the  new  window's  flag  settings  follow: 

1.  SUSPENDS_OUTPUT_ON_FULL  -  true, 

2.  I NPUT_COM?ONENT_ACT I VE  -  false, 

3.  OUTPUT_COMPONENT_ACT I VE  -  false, 

4.  OUTPUT_SUS PENDED  -  false. 

4 . 2 . 5 . 2  Syntax 

CR*EATE  OBJECT_TYPE  =>  W*INDOW, 

WINDOW  NAME  =>  <window  name> 


4.2. 5. 3  Command  Parameters 

1.  OBJECT_TYPE  =>  W*INDOW 

Specifies  that  a  new  window  is  to  be  created  in  the  AIM 
env i ronment . 

2.  WlNDOW_NAME  =>  <window  name> 

Specifies  the  name  of  a  new  window  to  be  created. 


4. 2. 5. 4  Examples 
4. 2. 5. 4.1  Long  Form 

AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_NAME  =>  WIN_i 
Create  an  AIM  window  named  WIN  1. 
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4 . 2 . 5 . 4 . 2  Mixed 

AIM>  CREATE  WINDOW  W I NDOW_NAME  =>  WIN_2 
Create  an  AIM  window  named  WIN_2. 

4. 2. 5. 4. 3  Short  Form 
AIM>  CR  W  WIN_3 

Create  an  AIM  window  named  WIN_3. 

4. 2. 5. 5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  name,  <window_name> ,  already  in  use" 

The  specified  window  name  already  exists  in  the  AIM 
env i ronment 

2.  "Identifier  name  is  too  long" 

The  specified  window  name  was  longer  than  20  characters 
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4,2*6  DEFINE  BINDING 

4.2,6. 1  Functional  Description 

The  DEFINE  BINDING  command  allows  the  AIM  user  to  bind  a  new  key 
sequence  to  the  specified  keystroke  command.  Initially  the  AIM 
assigns  default  values  for  the  key  sequences  that  are  associated  with 
the  keystroke  commands  (see  Appendix  A).  These  bindings  are 
maintained  by  Lhe  AIM  CLI  via  an  internal  table*  The  DEFINE  BINDING 
command  redefines  the  key  sequence  bound  to  a  specified  keystroke 
command  by  instructing  the  AIM  CLI  to  update  the  proper  entry  in  the 
keystroke  bindings  table. 

Not e :  The  bindings  established  via  the  DEFINE  BINDING  command  are  in 
effect  only  for  the  lifetime  of  the  AIM's  execution;  however,  the 
DEFINE  BINDING  command  may  be  included  in  the  AIM’s  initialization 
script  file  to  ensure  that  particular  keystroke  bindings  exist  every 
time  the  user  enters  an  AIM  session.  The  user  may  redefine  the  actual 
key  sequence  by  altering  the  Terminal  Capabilities  File. 

The  valid  AIM  keystroke  command  names  follow: 

1.  ABCRT_SCR I PT 

2 .  clea?_w:ndcw 

3.  NEX7_ IMAGE 

4 .  NEXT  J/ 1 EWPORT 

5.  NEXT_?AGE 

6 .  PREVIOUS  I MACE 

7 .  PREVIOUS  J/ 1 EWPORT 
3.  REDIS?LAY_SCREEN 

3  .  RETURN_TO_PREV  I  OUS_  I  MAGE 
C.  SWITCH  TO  AIM 


4 . 2 . 6 . 2  Syntax 


DEF*INE 


OBJECT_TYPE  =>  BLINDING, 

KEY_NAME  =>  <keystroke  command  name> 

FUNCTION  KEY  =>  <function  key> 
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4. 2. 6. 3  Command  Parameters 

1.  OBJECT_TYPE  =>  BLINDING 

Specifies  that  a  new  keystroke  binding  is  to  be  defined. 

2.  KEY_NAME  =>  <keystroke  command  name> 

Specifies  the  name  of  the  AIM  keystroke  command  whose 
associated  key  sequence  is  to  be  altered. 

3.  FUNCT I ON_KEY  =>  <funct ion_key> 

Specifies  tie  new  key  sequence  to  be  bound  to  the  specified 
AIM  keystro<e  command. 

4. 2. 6. 4  Examples 

4. 2. 6. 4.1  Long  Form 

AIM>  DEFINE  OBJ ECT_T YP E  =  >BINDING  KEY_NAME  =  >SWITCH_TO_AIM 
FUNCT I ON_KE Y  =  >  F10 

Bind  the  function  key  FIO  to  the  SWITCH_TO_AIM  keystroke 
command. 

4 . 2 . 6 . 4 . 2  Mixed 

AIM>  DEFINE  BINDING  KEY_NAME  =>  CLEAR_WINDOW  F2 

Bind  the  function  key  F2  to  the  CLEAR_WINDOW  keystroke  command. 

4. 2. 6. 4. 3  Short  Form 

AIM>  DEF  B  NEXT_V I EWPORT  F5 

Bind  the  function  key  F5  to  the  NEXT_VIEWPORT  keystroke 
command. 

4. 2. 6. 5  Errors 

Tne  semantic  errors  associated  with  this  command  include: 

1.  "Keyword:  <keyword>  can  NOT  be  completed" 

The  specified  keystroke  command  name  is  invalid 
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4.2.7  DEFINE  TERMINAL 

4.2.7. 1  Functional  Description 

The  DEFINE  TERMINAL  command  allows  the  AIM  user  to  dynamically  specify 
the  type  of  physical  terminal  being  used  to  communicate  with  the  AIM. 
This  command  is  used  to  ensure  that  the  AIM's  virtual  terminal 
interprets  and  transmits  the  physical  terminal's  control  sequences 
correct ly . 

4. 2.7. 2  Syntax 


DEF* I ME  C3JECT_TYPE  =>  T*ERMINAL , 

TERM I NAL_NAME  =>  <terminai  type> 


4 . 2 . 7 . 3  Command  Parameters 


1.  CBJECTJTYPE  =>  T*ERMINAL 

Specifies  that  the  terminal  type  is  to  be  changed. 

2.  TERM I NAL_NAME  ->  <terminal  type> 

Specifies  the  new  physical  terminal  ident i f i cat  ion . 


4 . 2 . 7 . 4  Ex  amp 1 e  s 
4. 2. 7. 4.1  Long  Form 

AIM>  DEFINE  03JECT_TYPE  =>  TERMINAL  TERMINAL_NAME  =>  vtlOO 
Reset  the  user's  terminal  type  to  be  a  VT100. 

Note :  The  AIM  is  capable  of  supporting  those  terminals  listed 

:n  the  Terminal  Capabilities  File  which  are  directly  supported 
by  the  underlying  KAPSE  (see  Chapter  5  for  a  description  of  the 
Terminal  Capabilities  File). 


4 . 2 . 7 . 4 . 2  Mixed 

AIM>  DEFINE  OBJECT_TYPE  =>  TERMINAL  ibm3278 

Reset  the  user's  terminal  type  to  be  an  IBM  3278. 
4. 2. ~.4. 3  Short  Form 
A I M>  DEF  T  t i 940 
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Reset  the  user's  terminal  type  to  be  a  TI940. 

4. 2. 7. 5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Keyword:  <keyword>  can  NOT  be  completed" 

The  specified  terminal  name  does  not  match  any  of  the  physical 
terminal  names  in  the  Terminal  Capabilities  File  (see  Chapter 
5  for  a  description  of  how  to  create  a  Terminal  Capabilities 
File  entry) 
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4.2.8  DELETE  IMAGE 

4. 2. 8.1  Functional  Description 

The  DELETE  IMAGE  command  allows  the  user  to  delete  an  image 
active  in  the  AIM  environment.  The  image  given  as  the  input 
is  deleted  from  the  internal  list  of  all  images  defined  in 
environment . 

4. 2. 8. 2  Syntax 


DEL*ETE  OBJECT_TYPE  =>  I *MAGE , 

IMAGE_NAME  =>  < image  name> 

4.2.8. 3  Command  Parameters 

1.  OBJECT_TYPE  =>  I *MAGE 

Specifies  that  an  image  is  to  be  deleted  from 
env i ronment . 

2.  IMAGE_NAME  =>  < image  name> 

Specifies  the  name  of  the  image  to  be  deleted. 


4. 2. 8. 4  Examples 

4. 2. 8. 4.1  Long  Form 

AIM>  DELETE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IM_1 
Delete  the  image  named  IM_1. 

4 . 2 . 8 . 4 . 2  Mixed 

AIM>  DELETE  IMAGE  IMAGE_NAME  »>  IM_2 
Delete  the  image  named  IM_2. 

4. 2. 8. 4. 3  Short  Form 
AIM>  DEL  I  IM_3 

Delete  the  image  named  IM_3. 


cur rent  1 y 
parameter 
the  AIM 


the  AIM 
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4. 2. 8. 5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Image  < image  name>  does  not  exist" 

The  specified  image  does  not  exist  in  the  AIM  environment 

2.  "Deleting  AIM  image  prohibited" 

The  specified  image  was  the  AIM  image  and  it  can  NOT  be 
deleted  1 
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4.2.9  DELETE  WINDOW 

4. 2. 9.1  Functional  Description 

The  DELETE  WINDOW  command  allows  the  user  to  delete  a  window  currently 
active  in  the  AIM  environment.  The  window  given  as  the  input 
parameter  is  deleted  from  the  internal  list  of  ail  windows  defined  in 
the  AIM  environment.  If  the  specified  window  has  an  active  pad,  the 
AIM  will  prompt  the  user  as  to  the  disposition  of  the  corresponding 
pad  f i le  < s )  . 

4 . 2 . 9 . 2  Syntax 


DEL*ETE  C3JECT_TY?E  =>  W*INDOW, 

W I NDOW_NAME  =>  < window  r.ame> 

4. 2. 9. 3  Command  Parameters 

1.  OSJECTJTYPE  =>  W* I NDOW 

Specifies  that  a  window  is  to  be  deleted  from  the  AIM 
env i ronment . 

2.  w i NDCW_NAME  =>  <window  name> 

Specifies  the  name  of  the  window  to  be  deleted. 

4. 2. 9. 4  Examples 

4. 2. 9. 4.1  Long  Form 

A IM>  DELETE  OBJECT_TYPE  =>  WINDOW  WINDOW_NAME  =>  WIN_1 
Delete  the  window  named  WIN_1. 

4 . 2 . 9 . 4 . 2  M i xed 

AIM>  DELETE  WINDOW  WINDOW_NAME  =>  WIN_2 
Delete  the  window  named  WIN_2. 

4.2. 9.4.3  Short  Form 
AIM>  DEL  W  WIN_3 

Delete  the  window  named  WIN  3. 
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4. 2. 9. 5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  does  not  exist  in  the  AIM  environment 

2.  "Deleting  AIM  window  prohibited" 

The  specified  window  was  the  AIM  window  and  it  CANNOT 
deleted 

3.  "Subordinate  Programs  Exist." 

Cannot  delete  a  window  with  subordinate  programs  running 


be 
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4.2.10  DISASSOCIATE 

4.2.10.1  Functional  Description 

The  DISASSOCIATE  command  removes  the  association  between  the  specified 
window  and  image.  The  appropriate  window-image  association  is  deleted 
from  the  AIM’s  internal  viewport  list. 

4.2.10.2  Syntax 


DISASSOCIATE  W I NDOW_NAME  =>  <window  name> 

IMAGE_NAME  =>  < image  name> 


4.2.10.3  Command  Parameters 


1.  WlNDOW_NAME  =>  < window  name> 

Specifies  the  window  to  be  disassociated  from  the  specified 
image . 

2.  IMAGE_NAME  =>  < image  name> 

Specifies  the  image  from  which  the  specified  viewport  will 
be  deleted. 


4.2.10.4  Examples 

4.2.10.4.1  Long  Form 

AIM>  DISASSOCIATE  W I NDOW_N AME  =>  WIN_1  IMAGE_NAME  =>  IM_1 
Remove  the  association  between  WIN_1  and  IM_1. 

4.2.10.4.2  Mixed 

AIM>  DISASSOCIATE  W I NDOW_NAME  =>  WIN_2  IM_2 

Remove  the  association  between  WIN_2  and  IM_2. 

4.2.10.4.3  Short  Form 
AIM>  DI  WIN_3  IM_3 

Remove  the  association  between  WIN  3  and  IM  3. 
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4.2.10.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>,  does  NOT 
(i.e.--no  window  of  that  name  has  been  created) 

2.  "Image  <image  name>  does  not  exist" 

The  specified  image  name,  < image  name>,  does  NOT 
(i.e.--no  image  of  that  name  has  been  created) 

3.  "Cannot  disassociate  the  AIM  window  from  the  AIM  image" 

An  attempt  to  disassociate  the  AIM  window  and  image  was 
the  AIM  program  prohibits  the  user  from  disassociating 
window  and  image 


exist 


exist 


made ; 
the  AIM 
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4.2.11  EXIT 

4.2.11.1  Functional  Description 

The  EXIT  command  will  terminate  execution  of  the  AIM  only  if  ALL 
subordinate  programs  have  terminated,  unlike  the  ABORT  command  which 
will  terminate  the  execution  of  the  AIM  regardless  of  the  current  AIM 
env i ronment . 

4.2.11.2  Syntax 
E*XIT 

4.2.11.3  Command  Parameters 
None . 

4.2.11.4  Examples 

4.2.11.4.1  Long  Form 

AIM>  EXIT 

Gracefully  exit  the  AIM  program. 

4.2.11.4.2  Mixed 
Not  applicable. 

4.2.11.4.3  Short  Form 
AIM>  E 

Gracefully  exit  the  AIM  program. 

4.2.11.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Subordinate  Programs  Exist." 

The  AIM  CANNOT  be  left  with  subordinate  programs  running. 
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4.2.12  GOTO  IMAGE 

4.2. 12. 1  Functional  Description 

The  GOTO  IMAGE  command  moves  the  cursor  to  the  top  of  the  named  image. 
The  specified  image  is  then  logically  connected  to  the  terminal's 
display. 

4.2.12.2  Syntax 


G*OTC  OBJECT_TYPE  =>  I *MAGE , 

IMAGE_NAME  =  >  < image  name> 


4.2.12.3  Command  Parameters 


1.  OBJECT_TYPE  =>  I *MAGE 

Specifies  that  the  cursor  will  be  positioned  in  the  top 
viewport  of  an  image. 

2.  IMAGE_NAME  =>  < image  name> 

Specifies  the  image  to  logically  connect  to  the  terminal's 
display. 


4.2.12.4  Examples 

4.2.12.4.1  Long  Form 

AIM>  GOTO  OBJECT_TYPE  =>  IMAGE  IMAGENAME  =>  IM_1 
Position  the  cursor  at  the  top  of  IM_1. 

4.2.12.4.2  Mixed 

AIM>  GOTO  IMAGE  IMAGE_NAME  =>  IM_2 

Position  the  cursor  at  the  top  of  IM_2. 

4.2.12.4.3  Short  Form 
AIM>  G  I  IM_3 

Position  the  cursor  at  the  top  of  IM_3. 
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4.2.12.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Image  <image  name>  does  not  exist” 

The  specified  image  name,  < image  name>,  does  NOT  exist 
fi.e.--no  image  of  that  name  has  been  created) 

2.  "Image,  < image_name> ,  not  associated  with  a  window” 

The  specified  image  name,  <“»mage  name>,  is  NOT  associated  with 
a  window 
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4.2.13  GOTO  WINDOW 

4.2.13.1  Functional  Description 

The  GOTO  WINDOW  command  moves  the  cursor  to  the  named  windoAi.  if  the 
specified  window  is  mapped  onto  more  than  one  image,  the  cursor  is 
positioned  at  the  top  of  the  largest  viewport  associated  with  that 
window.  Conflicts  between  viewports  of  identical  size  shall  be 
resolved  alphabet ical ly  by  image  names. 

4.2.13.2  Syntax 


G*OTC  OBJECT_TYPE  =>  W*INDOW, 

WINDOW  NAME  =>  <window  name> 


4.2.13.3  Command  Parameters 


1.  OBJ ECT_TYPE  =>  WMNDCW 

Specifies  that  the  cursor  wili  be  positioned  at  the  top  of 
a  window. 

2.  WINDOW_NAME  =>  <window  name> 

Specifies  the  window  name  that  is  to  become  the  current 
window  on  tne  user's  screen. 


4.2.13.4  Examples 


4.2.13 

.4.1  Long  Form 

A  IM> 

GOTO  OBJECT_TYPE  => 

WTNDOW 

W I NDOW_NAME  =>  WIN 

n 

1 

Position  the  cursor 
WIN_1. 

in  the 

largest 

viewport 

associated 

with 

4.2.13 

.4.2  Mixed 

AIM> 

GOTO  OBJECT_TYPE  => 

WINDOW 

W I  N_  2 

Position  the  cursor 
WIN_2 . 

in  the 

largest 

v i ewpor t 

assoc iated 

wit  r. 

4.2.13 

.4.3  Short  Form 

A I  M> 

G  W  WIN_3 

Position  the  cursor 

in  the 

largest 

v i ewpor t 

assoc iated 

wit  n 
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WIN_3 . 

4.2.13.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>,  does 
(i.e.--no  window  of  that  name  has  been  created) 

2.  "<wir.dow_r.ame>  not  associated  with  any  imagas" 

The  specified  window  name,  <window  name>,  is  NOT 
with  an  image 


NOT  exist 


assoc i ated 
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4.2.14  HELP 

4.2.14.1  Functional  Description 

The  HELP  command  invokes  the  AIM  HELP  utility.  which  provides 
information  to  the  user  about  the  operation  of  the  AIM  commands. 

4.2.14.2  Syntax 


H*ELP  (  <identifier>  { < ident i f ier> }  {*}  ) 


4.2.14.3  Command  Parameters 


<identifier>  {< ident i f ier> }  {*}  ) 

Specifies  one  or  more  AIM  keywords  that  indicate  what 
information  is  to  be  displayed.  If  you  specify  an  astrisk 
(*)  after  any  keyword,  ALL  heip  information  available  in 
the  AIM  HELP  file  at  that  level  is  displayed. 


4.2.14.4  Examples 

4.2.14.4.1  Long  Form 

AIM>  HELP  ASSOCIATE  PARAMETERS 

Display  all  the  available  AIM  help  information  describing  the 
parameters  of  the  ASSOCIATE  command. 

4.2.14.4.2  Mixed 
AIM>  HELP 

Display  a  list  of  the  available  top  level  AIM  HELP  topics. 

4.2.14.4.3  Short  Form 
AIM>  H 

Display  a  list  of  the  available  top  level  AIM  HELP  topics. 

4.2.14.5  Errors 


The  semantic  errors  associated  with  this  command  include: 


AIM  COMMANDS 
HELP 


1.  "Sorry,  no  documentation  available  on  <subject>" 

There  is  no  AIM  help  information  in  the  HELP  file  available 
for  the  specified  keyword  (<subject>) 
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4.2.15  INFO 

4.2.15.1  Functional  Description 

The  INFO  command  invokes  the  AIM  INFO  utility  which  provides  the  user 
with  AIM  environmental  information  such  as  information  about  images, 
windows,  keystroke  command  associations,  and  the  terminal  type. 

4.2.15.2  Syntax 


I*NFO  (  <identifier>  { < ident i f ier> }  {*}  ) 


4.2.15.3  Command  Parameters 


<identifier>  {< ident i f i er> {  {*}  ) 

Specifies  one  or  more  AIM  objects  that  indicate  what 
information  is  to  be  displayed.  If  you  specify  an  astrisk 
(*)  after  any  object,  ALL  AIM  environmental  information 
available  for  that  object  is  displayed. 


4.2.15.4  Examples 

4.2.15.4.1  Long  Form 

AIM>  INFO  WINDOWS  WIN_1  MODES 

Display  the  window  flag  settings  for  WIN_1. 

4.2.15.4.2  Mixed 
AIM>  INFO  WINDOWS 

Display  an  alphabetical  list  of  ALL  the  current  windows  in  the 
AIM  environment. 

4.2.15.4.3  Short  Form 
AIM>  I 

Display  a  list  of  ALL  objects  for  which  information  is 
available . 

4.2.15.5  Errors 


The  semantic  errors  associated  with  this  command  include: 


AIM  COMMANDS 
INFO 


1.  "Invalid  identifier:  < ident i f ier >" 

The  current  AIM  INFO  command  was  invalid 

2.  "Unrecognized  INFO  keyword  word,  <keywcrd>" 

There  is  no  AIM  information  available  for  the  specified  AIM 
keyword 

3.  "Invalid  INFO  command  after:  <input>" 

The  user  input  was  not  valid  after  the  specified  token. 

4.  "Invalid  INFO  command  beginning  at:  <input>" 

The  user  input  was  not  valid  beginning  at  the  specified  toKen, 

5.  "Image  <image_name>  does  not  exist" 

The  specified  image  does  not  exist 

6.  "Window  <window_name>  does  not  exist" 

The  specified  window  does  not  exist 


4-67 


AIM  COMMANDS 
RESET  AIM  SUSPENDS 


4.2.16  RESET  A IM_SUSPENDS 

4.2.16.1  Functional  Descr  i.pt  :or. 

The  RESET  AIM_SUSPENDS  command  assigns  a  boolean  value  of  FALSE  to  th 

AIM  global  variable,  SUSPENDIN'  AIM.  When  this  f.ag  :s  off,  no  APS 

program  output  suspension  occurs  when  the  SWITCH  TO_AIM  Keystroke  i 
depressed .  The  value  of  this  variable  is  checked  by  the  Cl  each  c.m 

the  SWITCH_TO_A:m  keystroke  :s  depressed  by  the  user.  If  it  is  TRUE 

the  Cl  suspe.nds  the  output  of  every  APSE  program  executing  u.oderneat 
the  AIM,  otherwise,  .no  special  action  is  taken.  The  default  value  fc 
this  flag  is  TRUE. 

4 . 2 . 1 6 . 2  Syntax 


R£SE*T  MODE  TYPE  =>  A*IM  SUSPENDS  ) 


4,2.16.3  Command  Parameters 


MCDE_TY?5  =>  A* ;m_SUS?ENDS 

Reset  the  SUSPSND_ON  AIM  flag. 


4.2.16.4  Examples 

4.2.16.4.1  Long  Form 

AIM>  RESET  MODE_TYPE  =>  aim_suspends 

Reset  the  global  SUSPENDCN  AIM  flag  to  FALSE. 

4.2.16.4.2  Mi xed 

a:m>  reset  aim_sus?ends 

Reset  the  global  SUSPEND_CN_AIM  flag  to  FALSE. 

4.2.16.4.3  Short  Form 
A 1M>  RESE  A 

Reset  the  global  SUSPEND_ON_AIM  flag  to  FALSE. 

4.2.16.5  Errors 

The  semantic  errors  associated  with  this  "ommand  include: 


AIM  COMMANDS 
RESET  FULL 


4.2.17  RESET  FULL 

4.2.17.1  Functional  Description 

The  RESET  FULL  command  assigns  a  boolean  value  of  FALSE  to  the 
specified  window's  SUSPENDS  OUTPUT_WHEN  FULL  flag.  When  this  flag 
setting  is  turned  off  for  a  window,  the  window's  output  will  scroll 
continuously.  The  default  setting  for  every  window  is  TRUE. 

4.2.17.2  Syntax 


RESE*T  MODE_TYPE  =>  F*ULL , 

WINDOW  NAME  =>  <window  name> 


4.2.17.3  Command  Parameters 


1.  MODE_TYPE  =>  F*ULL 

Reset  the  SUSPEND_OUTPUT_ON_FULL  flag  for  the  specified 
window. 

2.  WIND0W_NAME  =>  <window  name> 

Specifies  the  window  for  which  the  SUSPEND_WHEN_FULL  flag 
is  to  be  turned  off. 


4.2.17.4  Examples 

4.2.17.4.1  Long  Form 

AIM>  RESET  MODE_TYPE  =>  FULL  WINDOW_NAME  =>  WIN_1 

Turn  off  the  SUSPEND_WHEN_FULL  flag  associated  with  WIN_1. 
This  will  allow  continuous  scrolling  of  WIN_l's  output. 

4.2.17.4.2  Mixed 


AIM>  RESET  FULL  WINDOW  NAME  =>  WIN  2 


Turn  off  the  SUSPEND_WHEN_FULL  flag  associated  with  WIN_2. 
This  will  allow  continuous  scrolling  of  WIN_2's  output. 

4.2.17.4.3  Short  Form 


AIM>  RESE  F  WIN_3 

Turn  off  the  SUSPEND_WHEN_FULL  flag  associated  with  WIN_3. 
This  will  allow  continuous  scrolling  of  WIN_3's  output. 
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4.2.17.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>,  does  NOT  exist 
( i . e. --no  window  of  that  name  has  been  created) 
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4.2.18  RESET  INPUT_PAD 

4.2.18.1  Functional  Description 

The  RESET  INPUT_PAD  command  deactivates  the  input  pad  associated  with 
he  specified  window,  and  thus,  closes  the  corresponding  database 
i  le. 

4.2.18.2  Syntax 


RESE*T  MODE_TYPE  =>  I*NPUT_PAD, 

WINDOW  NAME  =>  <window  name> 


4.2.18.3  Additional  Parameters 


1.  MODE_TYPE  *>  I  *  I NPUT_PAD 

Reset  the  INPUT_COMPONENT_ACTIVE  flag  for  the  specified 
wi ndow. 

2.  WINDOW_NAME  =>  <window  name> 

Specifies  the  window  for  which  the  input  pad  is  to  be 
deact ivated. 


4.2.18.4  Examples 

4.2.18.4.1  Long  Form 

AIM>  RESET  MODE_TYPE  =>  INPUT_PAD  W I NDOW_NAME  =>  WIN_1 

Deactivate  the  input  pad  for  WIN_1.  This  causes  the 

corresponding  database  file  to  be  closed. 

4.2.18.4.2  Mixed 

AIM>  RESET  INPUT_PAD  WINDOW_NAME  =>  WIN_2 

Deactivate  the  input  pad  for  WIN_2.  This  causes  the 

corresponding  database  file  to  be  closed. 

4.2.18.4.3  Short  Form 
AIM>  RESE  I  WIN_3 

Deactivate  the  input  pad  for  WIN_3.  This  causes  the 

corresponding  database  file  to  be  closed. 


AIM  COMMANDS 
RESET  INPUT  PAD 


4.2.18.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>,  does  NOT  exis 
(i.e.--no  window  of  that  name  has  been  created) 
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4.2.19  RESET  OUTPUT_PAD 

4.2.19.1  Functional  Description 

The  RESET  OUTPUT_PAD  command  deactivates  the  output  pad  associated 
with  the  specified  window,  and  thus,  closes  the  corresponding  database 
file. 

4.2.19.2  Syntax 

RESE*T  MODE_TYPE  =>  0*UTPUT_PAD, 

WINDOW_NAME  =>  <window  name> 

4.2.19.3  Command  Parameters 

1.  MODE_TYPE  =>  0*UTPUT_PAD 

Reset  the  OUTPUT_COMPONENT_ACTI VE  flag  for  the  specified 
window. 

2.  WINDOW_NAME  *>  <window  name> 

Specifies  the  window  for  which  the  output  pad  is  to  be 
deactivated. 


4.2.19.4  Examples 

4.2.19.4.1  Long  Form 

AIM>  RESET  MODE_TYPE  =>  OUTPUT_PAD  W I NDOW_N AME  =>  WIN  1 

Deactivate  the  output  pad  for  WIN_1,  causing  the  corresponding 
database  file  to  be  closed. 

4.2.19.4.2  Mixed 

AIM>  RESET  OUTPUT_PAD  WINDOW_NAME  =>  WIN_2 
Deactivate  the  output  pad  for  WIN_2. 

4.2.19.4.3  Short  Form 
AIM>  RESE  I  WIN_3 

Deactivate  the  output  pad  for  WIN_3. 
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4.2.19.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>,  does  NOT  exist 
(i.e.--no  window  of  that  name  has  been  created) 
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4.2.20  RESET  PADS 

4.2.20.1  Functional  Description 

The  RESET  PADS  command  deactivates  both  the  input  and  output  pad  file 
associated  with  the  specified  window,  and  thus,  closes  the 
corresponding  database  files. 

4.2.20.2  Syntax 

RESE*T  MODE_TYPE  =>  P*ADS , 

WINDOW_NAME  =>  <window  name> 

4.2.20.3  Command  Parameters 

1.  MODE_TYPE  =>  P* ADS 

Reset  the  OUTPUT_COMPONENT_ACTIVE  and 

I N?U7_C0MP0NENT_ACT I VE  flags  for  the  specified  window. 

2.  w:ndCW_NAME  =>  <window  name> 

Specifies  the  window  for  which  the  input  and  output  pads 
are  to  be  deactivated. 

4.2.20.4  Examples 

4.2.20.4.1  Long  Form 

AIM>  RESET  MODE_TYPE=>PADS  WINDOW_NAME=>WIN_l 

Deactivate  the  input  and  output  pads  for  WIN_1. 

4.2.20.4.2  Mixed 

AIM>  RESET  PADS  WIN_2 

Deactivate  the  input  and  output  pads  for  WIN_2. 

4.2.20.4.3  Short  Form 
AIM>  RESE  P  WIN_3 

Deactivate  the  input  and  output  pads  for  WIN_3. 


AIM  COMMANDS 
RESET  PADS 


4.2.20.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  dees  not  exist" 

The  specified  window  name,  '-window  name>,  does  NOT 
(i.e.--no  window  of  that  name  has  eeen  created) 


e  x  i  s 


4-76 


AIM  COMMANDS 
RESUME  EXECUTION 


4.2.21  RESUME  EXECUTION 

4.2.21.1  Functional  Description 

The  RESUME  EXECUTION  command  directs  the  AIM  to  resume  execution  of 
the  specified  window's  suspended  APSE  program.  This  information  is 
displayed  in  the  program  status  field  of  the  window's  viewport  header 
("Running").  If  the  specified  window's  APSE  program  is  not  suspended, 
nothing  happens. 

4.2.21.2  Syntax 


RESU*ME  CBJECT_TYPE  =>  E*XECUTION, 

WINDOW  NAME  =>  <window  name> 


4.2.21.3  Command  Parameters 


1.  0BJECT_TYP5  =  >  E*XECUT I ON 

Specifies  that  the  execution  of  the  APSE  program  associated 
with  the  specified  window  is  to  be  resumed. 

2.  W I NDOW_NAME  =>  <window  name> 

Specifies  the  window  whose  associated  APSE  program 
execution  is  to  be  resumed. 


4.2.21.4  Examples 

4.2.21.4.1  Long  Form 

AIM>  RESUME  OBJECT_TYPE  =>  EXECUTION  W I NDOW_NAME  =>  WIN_1 
Resume  the  execution  of  the  APSE  program  associated  with  WIN_1. 

4.2.21.4.2  Mixed 

*  _ 

AIM>  RESUME  EXECUTION  WINDOW_NAM£  =>  WIN_2 

Resume  the  execution  of  the  APSE  program  associated  with  V  T  2. 

4.2.21.4.3  Short  Form 
AIM>  RESU  E  WIN_3 

Resume  the  execution  of  the  APSE  program  associated  with  WIN_3. 
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4.2.21.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  ^window  name>  does  not  exist" 

The  specified  window  name,  < window  name>  does  NOT 
(i.e.--no  window  of  that  name  has  been  created) 


exist 
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4.2.2  2  RESUME  F  INGRAM  •JU'rF  " 

4.2.22.1  Func t .  nal  s  : 

The  RESUME  PRCGKA'  "  ;  " 

of  the  specified  *  .  w  • 

program  assoc  i  t  -  • 

happens:  otherwise  t;.e  S' 

4.2.22.2  Syntax 

RESU*ME  03JECT_TYPE  =>  P*ROGRAM_OUTPUT , 

WIND0W_NAME  =>  <window  name> 

4.2.22.3  Command  Parameters 

1.  OBJECT_TYPE  =>  W* I NDOW  OUTPUT 

Specifies  that  the  output  of  the  APSE  program  associated 
with  the  specified  window  is  to  be  resumed. 

2.  w:.NDOW_NAME  =>  <window  name> 

Specifies  the  window  whose  APSE  program's  output  is  to  be 
resumed . 

4.2.22.4  Examples 

4.2.22.4.1  Long  Form 

AIM>  RESUME  OBJECT_TYPE  =>  PROGRAMJDUTPUT  W I NDOW_NAME  =>  WI*,_1 
Resume  the  output  of  the  APSE  program  associated  with  WIN_1. 

4.2.22.4.2  Mixed 

A I  M>  RESUME  PROGRAM_OUTPUT  WINDOW_NAME  =>  WIN_2 

Resume  the  output  of  the  APSE  program  associated  with  WIN_2. 

4.2.22.4.3  Short  Form 
A I M>  RESU  E  WIN_3 

Res’jme  the  output  of  the  APSE  program  associated  with  WIN_3. 


.  t  ne  Ou  .  O' . : 

i  io  not  s  o  o  r 
voc ■  t  ;  *  e  a  d  p r 


t.ae  outout 
: . om  “he  APSE 
./.acd,  nq 

:c  turned  _ 1 t . 
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4.2.22.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>  does  NOT 
(i.e.--no  window  of  that  name  has  been  created) 


ex  i  s 
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4.2.23  SCRIPT 

4.2.23.1  Functional  Description 

In  addition  to  the  normal  method  of  entering  AIM  commands 
interactively  through  the  terminal,  a  user  may  compose  command  scripts 
to  be  read  and  executed  by  the  AIM.  A  command  script  is  simply  a 
KAPSE  database  file  which  contains  AIM  commands.  The  user  may  create 
these  command  files  using  an  editor  available  in  an  APSE,  or  AIM 
sessions  may  be  logged  into  pads  which  may  be  edited  and  used  for 
command  scripts  later.  To  execute  a  command  script,  the  user  enters 
the  SCRIPT  command  and  provides  the  name  of  the  file  containing  the 
script.  As  a  command  script  is  executed,  each  command  is  echoed  in 
the  AIM  window.  The  AIM  provides  an  "ABORT  SCRIPT"  keystroke  command 
to  terminate  the  execution  of  a  command  script. 

Upon  invocation,  the  AIM  looks  for  a  user-created  Initialization 
Script  file.  The  name  of  this  script  file  is  specified  by  the  user 
when  the  AIM  program  is  invoked.  If  the  file  exists,  the  AIM 
automatically  performs  an  implicit  Swi tch-to-AIM  and  executes  the 
command  script.  If  the  file  does  not  exist,  no  error  message  is 
generated  and  the  AIM  session  will  begin  as  usual.  The  Initialization 
Script  benefits  the  user  with  a  specific  application,  who  wishes  to 
set  up  a  series  of  "predefined"  windows  and  images. 

Though  the  concept  of  the  command  script  is  simple,  there  are  some 
subtle  implications  associated  with  its  use,  which  are  explained 
below. 


1.  GOTO  command  in  a  script 

A  GOTO  command  in  a  command  script  switches  the  current  image 
being  displayed  to  something  other  than  the  AIM  image.  Therefore, 
if  the  commands  in  the  command  script  are  sent  to  the  new  image, 
they  will  not  be  received  by  the  AIM  command  interpreter.  The 
commands  will  not  be  recognized  and  will  cause  errors.  To 
alleviate  this  problem,  the  AIM  stacks  input  sources  and  switches 
from  script  execution  to  interactive  mode  upon  encountering  a  GOTO 
command.  The  user  may  then  interact  with  the  AIM  through  the 
current  window.  When  the  user  presses  the  SWITCH_TO_AIM  key 
sequence,  the  execution  of  the  previous  command  script  will 
resume.  The  user  may  allow  the  command  script  to  run  to 
completion,  or  may  abort  the  script  with  a  keystroke  command. 

2.  Keystroke  commands  in  a  script 

Since  none  of  the  keystroke  commands  are  applicable  during  the 
execution  of  a  command  script,  (except,  of  course,  ABORT_SCRIPT , 
which  would  not  make  much  sense  inside  a  script  file),  keystroke 
commands  are  not  allowed  in  command  scripts. 
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3.  Error  recovery  from  a  script 

AIM  textual  commands  in  a  script  file  are  processed  exactly  as  if 
the  user  had  entered  them  from  the  terminal.  However,  when  the 
AIM  detects  an  error  in  a  command  script,  the  AIM  sends  an  error 
message  to  the  terminal  and  terminates  the  command  script.  This 
is  to  ensure  that  errors  do  not  propagate  through  a  command  script 
(such  as  an  error  in  a  CREATE  command  which  could  affect 
subsequent  ASSOCIATE  commands)  and  possibly  jeopardize  user  data 
or  files. 

4.  Recursive  or  mutually  recursive  command  scripts 

Command  scripts  may  invoke  other  command  scripts  by  the  use  of  the 
SCRIPT  command.  the  new  command  script  ends,  control  is 
returned  to  the  "calling”  command  script,  and  execution  of  that 
command  script  is  resumed.  The  AIM  command  language  contains  no 
conditional  statements,  which  means  that  it  would  be  impossible  to 
end  recursion  once  it  was  started.  For  this  reason,  a  command 
script  that  calls  itself  or  two  command  scripts  which  call  each 
other  would  create  an  infinite  loop.  The  AIM  cannot  explicitly 
detect  recursive  scripts;  however,  recursive  execution  will  be 
prohibited  since  a  script(text)  file  may  be  opened  only  once  at 
any  given  time  [DOD83],  so  the  user  must  take  measures  to  ensure 
recursion  does  not  occur.  The  AIM  imposes  a  maximum  script 
nesting  level  of  seven;  exceeding  this  limit  will  cause  an  error 
message  to  be  generated  and  the  execution  of  all  command  scripts 
to  abort. 


4.2.23.2  Syntax 

SC*RIPT  FI LE_NAME  =>  <file  name> 

4.2.23.3  Command  Parameters 

1.  FILE_NAME  =>  <file  name> 

Specifies  the  file  which  contains  the  script. 


4.2.23.4  Examples 
4.2.23.4.1  Long  Form 

AIM>  SCRIPT  F I LE_NAME  =>  scriptl 

Execute  the  script  with  file  name  "scriptl"  (File  specifications  are 
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APSE  dependent). 

4.2.23.4.2  Mixed 
None . 

4.2.23.4.3  Short  Form 
AIM>  SC  scriptl 

Execute  the  script  with  file  name  "scriptl".  (File  specifications 
are  APSE  dependent.) 

4.2.23.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "No  such  script  file:  <file  name>" 

The  specified  file  name  does  NOT  exist 

2.  "File  cannot  be  opened" 

This  error  is  caused  when  a  script  file  cannot  be  opened; 
possible  causes  of  this  error  include: 

1.  the  script  file  is  already  open 

2.  the  AIM  does  not  have  read  access  for  the  script  file 

3.  "Maximum  script  nesting  level  surpassed" 

The  maximum  nesting  level  of  scripts  (7)  was  surpassed 


AIM  COMMANDS 
SET  AIM  SUSPENDS 


4.2.24  SET  AIM^SUSPENDS 

4.2.24.1  Functional  Description 

The  SFT  AIM_SUSFENDS  command  assigns  a  boolean  value  of  TRUE  to  the 
AIM  global  variable,  SUSPEND_ON_AIM .  When  th.s  flag  is  on,  APSE 
program  output  suspension  occurs  when  the  SWITCH_TO_AIM  keystroke  is 
depressed .  The  value  of  this  variable  is  checked  by  the  Cl  each  time 
the  SWITCH_ .  0_AIM  keystroxe  is  depressed  oy  the  user.  If  it  is  TRUE, 
the  Cl  suspends  the  output  of  every  APSE  program  executing  underneath 
the  AIM,  otherwise,  no  action  is  taken.  The  default  value  for  this 
f 1  eg  is  TRUE. 

4.2.24.2  Syntax 


SE*T  MODE  TYPE  =>  A* IM  SUSPENDS  ) 


4.2.24.3  Command  Parameters 


MODE  TYPE  =>  A* IM  SUSPENDS 


Set  the  SUSPEND_ON_AIM  flag. 

4.2.24.4  Examples 

4.2.24.4.1  Long  Form 

AIM>  SET  MCDE_TYPE  =>  AIM_SUSPENDS 

Set  the  global  SUSPEND_ON_AIM  flag  to  TRUE. 

4.2.24.4.2  Mixed 


A I M >  SET  AIM  SUSPENDS 


Set 

4.2.24.4.3 


the  global  SUSPEND_ON_AIM  flag  to  TRUE. 
Short  Form 


AIM>  SE  A 

Set  the  global  SUSPEND_ON_AIM  flag  to  IkUE. 

4.2.24.5  Errors 

The  semantic  errors  associated  with  this  command  include: 
None 
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4.2.25  SET  FULL 

4.2.25.1  Functional  Description 

The  SET  FULL  command  assigns  a  boolean  value  of  TRUE  to  the  specified 
window's  SUSPENDS_OUTPUT_WHEN_FULL  flag.  When  this  flag  setting  is 
turned  on  for  a  window,  the  window's  output  will  NOT  scroll 
continuously,  it  will  be  suspended  when  a  full  window  of  output  data 
has  been  generated.  The  default  setting  for  every  window  is  TRUE. 

4.2.25.2  Syntax 


SE*T  MODE__TYPE  =>  F*ULL , 

WINDOW  NAME  =>  <window  name> 


4.2.25.3  Command  Parameters 


1.  MCDE_TYPE  =>  F*ULL 

Set  the  SUSPEND_OUTPUT_ON_FULL  flag  for  the  specified 
window. 

2.  WINDCW_NAME  =>  <window  name> 

Specifies  the  window  for  which  the  SUSPEND_WHEN_FULL  flag 
is  to  be  turned  on. 


.2.25.4.1  Long  Form 

AIM>  SET  MODE_TYPE  =>  FULL  W I NDOW_NAME  =>  WIN_1 

Turn  on  the  SUSPEND_WHEN_FULL  flag  associated  with  WIN_1.  This 
will  stop  continuous  scrolling  of  WIN_l's  output. 

4.2.25.4.2  Mixed 

AIM>  SET  FULL  W I NDOW_NAME  =>  WIN_2 

Turn  on  the  SUSPEND_WHEN_FULL  flag  associated  with  WIN_2.  This 
will  stop  continuous  scrolling  of  WIN_2's  output. 

4.2.25.4.3  Short  Form 
AIM^  SE  F  WIN_3 

Turn  on  the  SUSPEND_WHEN_FULL  flag  associated  with  WIN_3.  This 
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will  stop  continuous  scrolling  of  WIN_3's  output. 

4.2.25.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>,  does  NOT  exist 
(i.e.--no  window  of  that  name  has  been  created) 
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4.2.26  SET  I NPUT_PAD 

4.2.26.1  Functional  Description 

The  SET  INPUT_PAD  command  activates  the  input  pad  associated  with  the 
specified  window,  and  thus,  opens  a  database  file  corresponding  to  the 
input  component  of  the  specified  window's  pad.  When  creating  an  input 


component 

for  a  window  which 

has  air 

eady  had  a  pad 

opened  for 

it 

( and 

then  closed 

a  u  p.  i  q  u  e 

database 

file 

will 

be  created  for 

the 

new 

component . 

* 

When  a  wind 

c-w's  input 

pad  is 

act i ve 

,  all 

input 

dest  i r.ed 

for 

the 

spec i f i ed 

w  i  ndow*  i  s 

also  wri 

t ten  ( 1 

ogged ) 

to  an  input  pad  fi 

le  . 

The 

AIM  automat 

icaliy  gene 

rates  a 

unique 

pad  f  i 

le  name. 

The  AIM 

command 

interpreter  positively  re-enforces  the  user  by  displaying  a  message 
indicating  the  name  of  the  created  file. 

4.2.26.2  Syntax 


SE*T  MODE  TYPE  =>  I *NPUT  PAD, 

WINDOW  NAME  =>  <window  name> 


4.2.26.2  Command  Parameters 


1.  MCDE_TY?E  =>  I  *  I NPUT_PAD 

Set  the  I NPUT_COMPONENT_ ACTIVE  flag  for  the  specified 
w i ndow , 

<- .  rt  ^  n w  i n<uc **  <n  am c - 

Specifies  the  window  for  which  the  input  pad  is  to  be 
act i vated . 


4.2.26.4  Examples 
4.2.26.4.1  Long  Form 

AIM>  SET  MODE_TYPE  =>  INPUT_PAD  WINDOW_NAME  =>  WIN_1 
*  *  * A I M  generated  input  pad  file  name:  WIN_1.INP 

Activate  the  input  pad  for  WIN_1. 

Note :  the  pad  file  names  generated  by  the  AIM  shall  adhere  to 
the  underlying  KAPSE's  file  naming  conventions. 
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4.2.26.4.2  Mixed 

AIM>  SET  INPUT_PAD  W I NDOW_NAME  =>  WIN_2 

Activate  the  input  pad  for  WIN_2.  The  AIM  generated  the  file 
name  of  WIN_2's  input  pad,  namely  WIN_2.INP. 

Note :  the  pad  file  names  generated  by  the  AIM  shall  adhere  to 
the  underlying  KAPSE's  file  naming  conventions. 

4.2.26.4.3  Short  Form 
AIM>  SE  I  WIN_3 

***AIM  generated  input  pad  file  name:  WIN_3.INP 

Activate  the  input  pad  for  WIN_3.  The  AIM  generated  the  file 
name  of  WIN_3's  input  pad,  namely  WIN_3.INP. 

Note:  the  pad  file  names  generated  by  the  AIM  shall  adhere  to 
the  underlying  KAPSE's  file  naming  conventions. 

4.2.26.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>,  does  NOT  exist 
(i.e.--no  window  of  that  name  has  been  created) 

2.  "Input  Pad  for  window  <window_name>  is  already  active" 

An  input  pad  is  already  active  for  the  specified  window 

3.  "File  cannot  be  opened" 

The  specified  pad  file  cannot  be  opened;  possible  causes  of 
this  error  include: 

1.  the  file  is  already  open 

2.  the  AIM  does  not  have  read  access  for  the  file 
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S-:  OUT?’JT_?AD 

Functional  Description 

The  SET  G'JT?LT_P AD  command  activates  the  output  pad  associated  with 
~he  specified  window,  and  thus,  opens  the  database  file  associated 
with  the  output  component  of  the  specified  window's  pad.  when 
creating  an  output  component  for  a  window  which  has  already  had  a  pad 
opened  fcr  it  ; and  then  closed),  a  unique  database  file  will  ce 
created  fur  the  new  component. 

when  a  window's  output  pad  is  active,  a.'  output  destines  fcr  tie 
so^a'*'*fied  w  '  d  ^  v  s  ^  '  s  ^  w  r  i  r  f  s  n  1  '  o  c  g  e  d  •  *■  o  an  o  u  r  o  u  *  o  a  d  r  ’  e  T  n  e 

AIM  automatically  generates  a  unique  pad  file  name.  The  AIM  command 
interpreter  positively  re-enforces  the  user  by  display  me  a  message 
i n  d i c  a  1 1  n  c  the  name  of  the  created  file. 

** .  c  «  u  .  z.  Syntax 

SE*T  MCDE_TY?E  =>  C *LT?UT_PAD , 

w  I  NDCW  NAME  -  >  <■  w :  ndov  name  ' 

4.2.2*'.  3  Command  Parameters 


1.  MCDE  TYPE  =>  0*UTP\jT  PAD 

Set  the  OUTPTJT_COMPONENT_ACT  I  YE  flag  for  the  specified 
v : ndc v . 

2.  WINDOW  NAME  =>  <windov  name > 

Specifies  the  window  for  which  the  output  pad  is  to  be 
act  i vat ed . 


4 . 2 . 2 7 . 4  Examples 
4.2  27 . 4 . 1  Long  Form 


i 


a:m>  set  MODE_TYPE  =>  OUTPUT_PAD  window_name  =>  WIN_1 
*  *  * A I M  generated  output  pad  file  name:  WIN_1.0UT 


Activate  the  output  pad  for  WIN  1 .  The  AIM  CLI  generated  the 
file  name  of  WIN_l’s  output  pad7  namely  WIN_1.0UT. 

Note :  the  pad  file  names  generated  by  the  AIM  shall  adhere  to 
the  underlying  KAPSE's  file  naming  conventions. 
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4.2.27.4.2  Mixed 

AIM>  SET  OUTPUT_PAD  WINDOW_NAME  =>  WIN_2 
***AIM  generated  output  pad  file  name:  WIN_2.0UT 

Activate  the  output  pad  for  WIN_2.  The  AIM  CLI  generated  the 

file  name  of  WlN_2's  output  pad,  namely  WIN_2.0UT. 

Note :  the  pad  file  names  generated  by  the  AIM  shall  adhere  tc 
the  underlying  KAPSE's  file  naming  conventions. 

4.2.27.4.3  Short  Form 
AIM>  SE  0  WIN_3 

* **AIM  generated  output  pad  file  name:  WIN_3.0UT 

Activate  the  output  pad  for  WIN_3.  The  AIM  CLI  generated  the 

file  name  of  WlN_3's  output  pea,  namely  WIN  3. OUT. 

Note :  the  pad  file  names  generated  by  the  AIM  shall  adhere  tc 
the  underlying  KAPSE's  file  naming  conventions. 

4.2.27.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>,  does  NOT  exist 
(i.e.--no  window  of  that  name  has  been  created) 

2.  "Output  Pad  for  window:  <window_name>  is  already  active" 

An  output  pad  is  already  active  for  the  specified  window 

3.  "File  cannot  be  opened" 

The  specified  pad  file  cannot  be  opened.  Possible  causes  of 
this  error  include: 

1.  the  file  is  already  open 

2.  the  AIM  does  not  have  read  access  for  the  file 
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4.2.28  SET  PADS 

4.2.28.1  Functional  Description 

The  SET  PADS  command  activates  both  an  input  and  output  pad  file  for 
the  specified  window,  and  thus,  opens  database  files  associated  with 
the  input  and  output  component  of  the  specified  window's  pad.  When 
creating  an  input  or  output  component  for  a  window  which  has  already- 
had  a  pad  opened  for  it  (and  then  closed),  a  unique  database  file  will 
be  created  for  the  new  component ( s ) . 

When  a  window's  input  pad  is  active,  all  input  destined  for  the 
specified  window  is  also  written  (logged)  to  an  input  pad  file,  and 
when  an  output  pad  is  active,  all  output  destined  for  the  specified 
window  is  also  logged  in  the  output  pad  file.  The  AIM  automatically 
generates  a  unique  pad  file  name.  The  AIM  command  interpreter 
positively  re-enforces  the  user  by  displaying  a  message  indicating  the 
name  of  the  created  file. 

4.2.28.2  Syntax 


SE*T  MODE_TYPE  =>  P*ADS, 

WINDOW  NAME  =>  <window  name> 


4.2.28.3  Command  Parameters 


1.  MODE_TYPE  =>  P*  ADS 

Set  the  OUTPUT_COMPONENT_ACT I VE  and  INPUT_COMPONENT_ACTI VE 
flags  for  the  specified  window. 

2.  WINDOW_NAME  =>  <window  name> 

Specifies  the  window  for  which  the  input  and  output  pads 
are  to  activated. 


4.2.28.4  Examples 
4.2.28.4.1  Long  Form 

AIM>  SET  MODE_TYPE  =>  PADS  W I NDOW_NAME  =>  WIN_1 

Activate  the  input  and  output  pads  for  WIN_1. 

***AIM  generated  input  pad  file  name:  WIN_1.INP 
***AIM  generated  output  pad  file  name:  WIN_1.0UT 

The  AIM  command  interpreter  generated  the  input  and  output  pad 
file  names  to  he  associated  with  WIN_1,  namely  WIN_1.INP  and 
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WIN_1 . OUT . 

Note :  the  pad  file  names  generated  by  the  AIM  shall  adhere  to 
the  underlying  KAPSE's  file  naming  conventions. 

4.2.28.4.2  Mixed 
AIM>  SET  PADS  WIN_2 

Activate  the  input  and  output  pads  for  WIN_2. 

***AIM  generated  input  pad  file  name:  WIN_2.INP 
***AIM  generated  output  pad  file  name:  WIN_2.0UT 

The  AIM  command  interpreter  generated  the  input  and  output  pad 
file  names  to  be  associated  with  WIN_2,  namely  WIN_2.INP  and 
WIN_2 . OUT . 

Note :  the  pad  file  names  generated  by  the  AIM  shall  adhere  to 
the  underlying  KAPSE's  file  naming  conventions. 

4.2.28.4.3  Short  Form 
AIM>  SE  P  WIN_3 

***AIM  generated  input  pad  file  name:  WIN_3.INP 
***AIM  generated  output  pad  file  name:  WIN_3.0UT 

Activate  the  input  and  output  pads  for  WIN_3.  The  AIM  command 
interpreter  generated  the  input  and  output  pad  file  names  to  be 
associated  with  WIN_3,  namely  WIN_3.INP  and  WIN_3.0UT. 

Note :  the  pad  file  names  generated  by  the  AIM  shall  adhere  to 
the  underlying  KAPSE's  file  naming  conventions. 

4.2.28.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>,  does  NOT  exist 
(i.e. — no  window  of  that  name  has  been  created) 

2.  "Input  Pad  for  window:  <window_name>  is  already  active" 

An  input  pad  is  already  active  for  the  specified  window 

3.  "Output  Pad  for  window:  <window_name>  is  already  active" 

An  output  pad  is  already  active  for  the  specified  window 
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4.  "File  cannot  be  opened" 

The  specified  pad  file  cannot  be  opened;  possible  causes 
this  error  include: 

1.  the  file  is  already  open 

2.  the  AIM  does  not  have  read  access  for  the  file 


COMMANDS 
SET  PADS 


of 
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4.2.29  SUSPEND  EXECUTION 

4.2.29.1  Functional  Description 

The  SUSPEND  EXECUTION  command  directs  the  AIM  to  suspend  execution  of 
the  specified  window's  APSE  program.  This  information  is  displayed  in 
the  program  status  field  of  the  window's  viewport  header 
("Suspended").  If  the  specified  window's  APSE  program  is  already 
suspended,  nothing  happens. 

4.2.29.2  Syntax  ■ 


SU*SPEND  OBJECT_TYPE  =>  EXECUTION, 

WINDOW  NAME  ->  <window  name> 


4.2.29.3  Command  Parameters 


1.  OBJECT_TYPE  =>  E*XECUTION 

Specifies  that  the  execution  of  the  APSE  program  associated 
with  the  specified  window  is  to  be  suspended. 

2.  W I NDOW_NAME  =>  <window  name> 

Specifies  the  window  whose  associated  APSE  program 
execution  is  to  be  suspended. 


4.2.29.4  Examples 
4. 2. 29. '4.1  Long  Form 

AIM>  SUSPEND  OBJECT_TYPE  =>  EXECUTION  W I NDOW_NAME  =>  WIN_1 
Suspend  the  execution  of  the  APSE  program  associated  with  WIN_1. 

4.2.29.4.2  Mixed 

AIM>  SUSPEND  EXECUTION  W I NDOW_NAME  =>  WIN_2 

Suspend  the  execution  of  the  APSE  program  associated  with  WIN_2. 

4.2.29.4.3  Short  Form 
AIM>  SU  E  WIN_3 

Suspend  the  execution  of  the  APSE  program  associated  with  WIN_3. 
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4.2.29.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>,  does  NOT  exist 
(i.e.--no  window  of  that  name  has  been  created) 
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4.2.30  SUSPEND  PROGRAM_OUTPUT 

4.2.30.1  Functional  Description 

The  SUSPEND  PROGRAM_OUTPUT  command  directs  the  AIM  to  suspend  the 
output  of  the  specified  window's  APSE  program.  If  the  outpjt  from  the 
APSE  program  associated  with  the  specified  window  is  already  suspended 
then  nothing  happens;  otherwise,  the  'S'  flag  in  the  viewport  header 
is  turned  on. 

4.2.30.2  Syntax 


SU*SPEND  OBJECT_TYPE  =  >  W* INDOW_OUTPUT , 
WINDOW  NAME  =>  <window  name> 


4.2.30.3  Command  Parameters 

1.  08JECT_TYPE  =  >  W* INDOW_OUTPUT 

Specifies  that  the  output  of  the  APSE  program  associated 
with  the  specified  window  is  to  be  suspended. 

2.  WINDOW_NAME  =>  <window  name> 

Specifies  the  window  whose  APSE  program’s  output  is  to  be 
suspended. 

4.2.30.4  Examples 

4.2.30.4.1  Long  Form 

AIM>  SUSPEND  OBJECT_TYPE  =>  PROGRAMjOUTPUT  WINDOW_NAME  =>  WIN_1 
Suspend  the  output  of  the  APSE  program  associated  with  WIN_1. 

4.2.30.4.2  Mixed 

AIM>  SUSPEND  PROGRAM_OUTPUT  W I NDOW_NAME  =>  WIN_2 

Suspend  the  output  of  the  APSE  program  associated  with  win_2. 

4.2.30.4.3  Short  Form 
AIM>  SU  E  WIN_3 

Suspend  the  output  of  the  APSE  program  associated  with  WIN  3. 
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4.2.30.5  Errors 

The  semantic  errors  associated  with  this  command  include: 

1.  "Window  <window  name>  does  not  exist" 

The  specified  window  name,  <window  name>,  does  NOT  exist 
(i.e.--no  window  of  that  name  has  been  created) 
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4.2.31  TERMINATE  EXECUTION 

4.2.31.1  Functional  Description 

The  TERMINATE  EXECUTION  command  directs  the  AIM  to  TERMINATE  execution 
of  the  program  in  the  specified  window.  Tf  there  is  not  a  program 
running  in  the  specified  window,  no  action  is  taken. 

4.2.31.2  Syntax 


TERMINATE  OBJECT_TYPE  =>  E*XECUTION, 

WINDOW  NAME  =>  <window  name> 


4.2.31.3  Command  Parameters 

1.  OBJECT_TYPE  =>  E EXECUTION 

Specifies  that  the  execution  of  the  APSE  program  associated 
with  the  specified  window  is  to  be  terminated. 

2.  WINDOW_NAME  =>  <window  name> 

Specifies  the  window  whose  associated  APSE  program 
execution  is  to  be  terminated. 

4.2.31.4  Examples 

4.2.31.4.1  Long  Form 

AIM>  TERMINATE  OBJECT_TYPE  =>  EXECUTION  W I NDOW_NAME  =>  WIN_1 
TERMINATE  the  execution  of  the  APSE  program  associated  with  WIN_1. 

4.2.31.4.2  Mixed 

AIM>  TERMINATE  EXECUTION  WINDOW_NAME  =>  WIN_2 

TERMINATE  the  execution  of  the  APSE  program  associated  with  WIN_2. 

4.2.31.4.3  Short  Form 
AIM>  T  E  WIN_3 

TERMINATE  the  execution  of  the  APSE  program  associated  with  WIN_3. 

4.2.31.5  Errors 

The  semantic  errors  associated  with  this  command  include: 
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1.  "No  subordinate  process  exists  in  window:  <window_name>" 

There  was  no  process  to  terminate  in  the  specified  window 
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4 . 3  KEYSTROKE  COMMANDS 

This  section  describes  the  Keystroke  Commands  available  in  the  AIM. 
Because  the  keystrokes  are  terminal  dependent  the  user  is  directed  to 
find  the  format  and  examples  of  a  particular  keystroke  in  the 
appendices  for  the  terminal  type  being  used. 

There  are  also  no  errors  associated  with  the  keystrokes. 
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4.3.1  A30RT_  SCRI PT 

4 . 3 . 1 . 1  Funct ional  Description 

The  ABORT_SCRIPT  command  allows  the  user  to  abort  a  script.  This 
command  will  abort  all  scripts  that  are  currently  running.  If  the 
scripts  are  nested,  all  scripts  are  aborted  regardless  of  which  script 
is  executing  when  the  abort  keystroke  is  entered. 

4. 3. 1.2  Format/Examples 

See  Appendix  A  for  examples  using  your  specific  terminal  type. 
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4.3.2  CLEAR_W I NDOW 

4. 3. 2. 1  Functional  Description 

The  CLEAR  WINDOW  keystroke  command  allows  the  user  to  blank 
current  window  of  all  information  except  the-  header. 

4. 3. 2. 2  Format/Examples 

See  Appendix  A  for  examples  using  your  specific  terminal  type. 


the 
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4.3.3  NEXT_IMAGE 

4. 3. 3.1  Functional  Description 

The  NEX?_IMAGE  keystroke  command  switches  the  cursor  from  the  current 
image  to  the  one  that  would  follow  if  all  the  images  were  put  in  an 
Iphabetized  list.  If  none  follows,  the  cursor  moves  to  the  image 
hat  would  be  first  in  the  alphabetized  list. 

4. 3. 3. 2  Format/Examples 

See  Appendix  A  for  examples  using  your  specific  terminal  type. 
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4.3.4  NEXT_PAGE 

4. 3. 4.1  Functional  Description 

The  NEXT_PAGE  keystroke  command  displays  the  next  output  page.  T.nis 
command  is  used  when  the  "More.."  flag  is  set  indicating  that  more 
text  is  available  than  is  currently  di splayed . 

4. 3. 4. 2  Format/Examples 

See  Appendix  A  for  examples  using  your  specific  terminal  type. 
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4.3.5  NEXT_V I EWPORT 

4. 3. 5.1  Functional  Description 

The  NEXT_V I EWPORT  keystroke  command  switches  the  cursor  from  the 
current  viewport  to  the  one  that  follows.  If  none  follows,  the  cursor 
moves  to  the  viewport  at  the  top  of  the  image. 

4. 3. 5. 2  Format/Examples 

See  Appendix  A  for  examples  using  your  specific  terminal  type. 
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4.3.6  PREV I OUS_ I MAGE 

4. 3. 6.1  Functional  Description 

The  PREVIOUS_IMAGE  keystroke  command  switches  the  cursor  from  the 
current  image  to  the  one  that  would  precede  it  if  all  the  images  were 
put  in  an  alphabetized  list.  If  there  is  no  previous  image,  the 
cursor  moves  to  the  image  that  would  be  last  in  the  alphabetized  list. 

4. 3. 6. 2  Format/Examples 

See  Appendix  A  for  examples  using  your  specific  terminal  type. 
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4.3.7  PREV I OUS_V I EWPORT 

4. 3. 7.1  Functional  Description 

The  PREVlOUS_VIEWPORT  keystroke  command  switches  the  cursor  from-  the 
viewport,  where  it  currently  exists,  to  the  previous  viewport  on  the 
image.  If  there  is  none,  the  cursor  moves  to  the  viewport  that  is 
last  on  the  image. 


4. 3. 7. 2  Format/Examples 

See  Appendix  A  for  examples  using  your  specific  terminal  type. 
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4.3.8  RED I SPLAY_SCREEN 

4. 3. 8.1  Functional  Description 

The  REDISPLAY_SCREEN  keystroke  command  will  redisplay  the  entire 
screen.  This  command  is  useful  in  cases  where  system  messages  are 
written  over  the  information  on  the  screen  and  the  user  wishes  to  nave 
the  original  data  redisplayed. 

4. 3. 8. 2  Format/Examples 

See  Appendix  A  for  examples  using  your  specific  terminal  type. 
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4.3.9  RETURN_TO_PR£V I OUS^ I MAGE 
4. 3.9.1  Functional  Description 

The  RETURN  TO_PREVIOUS_IMAGE  keystroke  returns  the  cursor  to  the 
previous  Image.  This  keystroke  differs  from  the  PREVIOUS_IMAGE 
keystroke  in  that  this  return  is  not  based  on  alphabetical  ordering. 
Instead,  with  this  keystroke,  the  cursor  simply  returns  whatever  image 
it  was  previously  in.  If  this  command  is  entered  as  the  first  entry 
into  the  AIM  image,  nothing  will  happen. 

4.  3.9.2  Format/Examples 

See  Appendix  A  for  examples  using  your  specific  terminal  type. 
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4.3.10  SW I TCH_TO_A I M 

4.3.10.1  Functional  Description 

The  SWITCH_TO_AIM  keystroke  command  transfers  control  to  the  AIM 
image.  If  the  SUSPEND_0N_AIM  flag  is  set,  then  all  output  to  other 
windows  is  suspended  until  the  user  resumes  output  to  those  windows. 
The  default  is  no  suspension  on  SWITCH_TO_AIM ,  which  means  output  to 
windows  will  continue  asynchronously  while  the  user  interacts  with  the 
AIM  image. 

4.3.10.2  Format/Examples 

See  Appendix  A  for  examples  using  your  specific  terminal  type. 
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This  chapter  is  a  presentation  of  the  conditions  surrounding  the 
operation  of  the  AIM  computer  program  within  the  Data  General  Ada 
Development  Environment (ADE) .  The  first  section  discusses  the  steps 
necessary  to  properly  execute  the  AIM  program;  the  second  and  third 
sections  respectively  discuss  the  AIM's  expected  input  and  output. 

5.1  OPERATING  PROCEDURES 

This  section  discusses  the  setup,  invocation,  and  termination  of  the 
AIM  program. 

5.1.1  AIM  Setup 

The  following  ADE  files  must  be  visible  from  the  current  working 
directory  (directly  or  via  the  current  searchlist)  prior  to  the 
invocation  of  the  AIM  program: 

1.  AIM  Executable  Imaqe( AIM. PR)  --  the  AIM's  executable  program 
image. 

2.  Terminal  Ident i f icat ion  Fi le ( TERM)  --  file  containing  the  name  of 
the  user’s  terminal  to  be  used  with  the  AIM  program. 

3.  Terminal  Capabi 1 ites  Fi le(TCF)  —  the  file  containing  a  tablular 
descript ion  of  the  capability  of  specific  ANSI  terminals  that  will 
be  used  in  conjuntion  with  the  AIM  program. 

4.  AIM  Help  File(AIM  HELP  FILE)  --  the  AIM's  on-line  Help  file 
describing  the  AIM's  textual  and  keystroke  commands. 

5.  AIM  Parse  Table  File(AIM  PARSE  TABLE  FILE)  —  the  AIM  parser  input 
tables  automatically  generated  by  the  NYU  LALR  Parser  Generator 
when  given  a  BNF  description  of  the  AIM  grammar. 
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6.  AIM  Initialization  Script  FiletAIM  INIT  SCRIPT  FILE)  --  an 
optional  AIM  command  script  file  that  is  executed,  if  it  exists, 
as  part  of  the  AIM  initialization. 

Note :  the  format  and  content  of  these  files  will  be  presented  in  the 

Input  Section(5.2)  of  this  chapter. 

5.1.2  AIM  Invocation 

Once  all  of  the  AIM  setup  requirements  have  been  met,  the  AIM  can  be 
invoked  by  the  user  via  the  ADE  execute  command: 

-)  XECUTE  AIM 

5.1.3  AIM  Termination 

The  AIM  ceases  processing  and  returns  to  the  ADE  upon  user  request  via 
the  ABORT_AIM  or  EXIT  command.  The  ABORT_AIM  command  effects  an 
unconditional  termination  of  the  AIM  program  irregardless  of  any 
subordinate  programs  running  underneath  the  AIM.  The  EXIT  command 
will  terminate  the  execution  of  the  AIM  program,  if  and  only  if,  the 
AIM  does  not  have  any  subordinate  (grandson)  processes;  otherwise,  a 
warning  error  will  be  generated  and  the  AIM  continues  its  execution. 

5.2  AIM  INPUTS 

The  AIM  has  seven  areas  where  input  is  necessary: 


1 . 

Keyboard , 

2. 

Terminal  Identification 

File, 

3. 

Terminal  Capabilities  Fi 

He, 

4. 

AIM  Help  File, 

5. 

AIM  Parse  Table  File, 

6. 

AIM  Initialization  Script  File,  and 

7. 

User  defined  AIM  Script 

Files . 

A  discussion  of  each  follows. 


5.2.1  Keyboard 

5. 2. 1.1  Purpose  And  Use 

Keyboard  input  allows  the  AIM  user  to  enter  AIM  commands  and  ADE 
program  data. 
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5. 2. 1.2  Input  Media 

The  source  of  the  AIM's  keyboard  input  is  the  user's  terminal 
keyboard . 

5. 2. 1.3  Format 

The  AIM’s  keyboard  input  can  take  the  form  of  a  stream  of  single 
characters,  or  a  full  line  of  information. 

5. 2. 1.4  Content 

The  AIM's  keyboard  input  contains  AIM  commands  and  input  data  for  APSE 
programs  within  the  ADE. 

5.2.2  Terminal  Identification  File 

5. 2. 2.1  Purpose  And  Use 

The  user's  terminal  name  is  identified  by  using  standard  Ada  TEXT_IO. 
The  terminal  name  is  read  in  from  the  TERM  file. 

5. 2. 2. 2  Input  Media 

The  user's  terminal  name  is  stored  in  an  ADE  database  file  named  TERM. 

5. 2. 2. 3  Format 

The  TERM  file  is  a  single  line  ASCII  text  file  specifying  the  (case 
sensitive)  name  of  the  user's  terminal  beginning  in  column  1. 

5. 2. 2. 4  Content 

A  bug  in  the  run-time  support  of  the  ADE  caused  the  END_OF_FILE 
exception  to  be  raised  prematurely  when  reading  the  TERM  file.  Due  to 
this,  a  dummy  line  has  to  be  placed  after  the  line  containing  the 
terminal  name.  An  example  file  would  look  like: 

tv970 

dummy  line 

where  "tv970"  is  the  terminal  name  to  be  used  with  the  AIM  program. 

5.2.3  Terminal  Capabilities  File 
5. 2. 3.1  Purpose  And  Use 

The  Terminal  Capabilities  File  (TCF)  is  a  data  base  of  terminal 
capability  descriptions.  Terminals  are  described  in  the  TCF  by  giving 
a  set  of  capabilities  which  they  have,  and  by  describing  how 
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operations  are  performed. 

When  invoked,  the  AIM  opens  the  TCF,  searches  for  the  terminal  name 
specified  in  the  TERM  file,  and  initializes  the  Virtual  Terminal  data 
structures  with  the  corresponding  terminal's  capabilities. 

5. 2. 3. 2  Input  Media 

The  AIM  Terminal  Capabilities  File  is  stored  in  an  ADE  database  file 
named  TCF. 

5.2. 3.  3  Format 

The  Terminal  Capabilities  File  is  a  variation  of  the  TERMCAP  developed 
in  the  Berkeley  extensions  to  the  UNIX  operating  system.  It  contains 
a  series  of  entries  that  describe  the  capabilities  of  various 
terminals.  Each  entry  is  composed  of  fields  separated  by  colons 
multiple  lines  can  be  included  in  an  entry  by  placing  a  ' \ '  at 
the  end  of  each  line  except  for  the  last  one  of  the  entry. 

The  first  entry  for  each  terminal  gives  the  names  which  are  known  for 
the  terminal,  separated  by  "I"  characters.  The  first  name  is  always  2 
characters  long  and  is  used  by  older  UNIX  systems  which  score  the 

terminal  type  in  a  16  bit  word  in  a  system-wide  data  base.  The  second 

name  given  is  the  most  common  abbreviation  for  the  terminal,  and  the 
last  name  given  should  be  a  name  fully  identifying  the  terminal.  This 
second  name  is  the  one  that  is  matched  against  the  contents  of  the 

TERM  file  (note  that  this  string  search  is  case  sensitive).  The 

second  name  should  contain  no  blanks;  the  last  name  may  well  contain 
blanks  for  readability. 

The  remainder  of  the  fields  are  specified  via  2  letter  codes  coupled 
with  optional  value  fields.  A  description  of  all  the  two  letter 
mnemonics  follows: 

(P)  indicates  padding  may  be  specified. 

Padding  is  an  amount  of  time  to  be  waited  after  the 
command  is  executed. 


Name 

Type 

Pad? 

Description 

al 

str 

(P) 

Add  new  blank  line 

be 

str 

(P) 

Bell 

cd 

str 

(P) 

Clear  to  end  of  display 

CO 

num 

Number  of  columns  in  a  line 

ce 

str 

(P) 

Clear  to  end  of  line 

cm 

str 

(P) 

Cursor  motion 

dc 

str 

(P) 

Delete  character 

dl 

str 

(P) 

Delete  line 

e  i 

str 

End  insert  mode 

gO 

str 

sent  by  terminal  function  key 
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gi 

str 

Terminal  Capab 

sent  by  terminal  function  key  21 

g2 

st  r 

Sent  by  terminal  function  key  22 

g3 

str 

Sent  by  terminal  function  key  23 

g4 

str 

Sent  by  terminal  function  key  24 

g5 

str 

Sent  by  terminal  function  key  25 

g6 

str 

Sent  by  terminal  function  key  26 

g7 

str 

Sent  by  terminal  function  key  27 

g8 

str 

Sent  by  terminal  function  key  28 

g9 

str 

Sent  by  terminal  function  key  29 

nO 

str 

Label  on  function  key  20 

hi 

str 

Label  on  function  key  21 

h2 

str 

Label  on  function  key  22 

h3 

str 

Label  on  function  key  23 

h4 

str 

Label  on  function  key  24 

h5 

str 

Label  on  function  key  25 

h6 

str 

Label  on  function  key  26 

h7 

str 

Label  on  function  key  27 

h8 

str 

Label  on  function  key  28 

h9  ' 

str 

Isabel  on  function  key  29 

im 

str 

Enter  insert  character  mode 

is 

str 

Terminal  initialization  string 

kl  • 

str 

Sent  by  terminal  function  key  1 

k2 

str 

Sent  by  terminal  function  key  2 

k3 

str 

Sent  by  terminal  function  key  3 

k4 

str 

Sent  by  terminal  function  key  4 

k5 

str 

Sent  by  terminal  function  key  5 

k6 

str 

Sent  by  terminal  function  key  6 

k7 

str 

Sent  by  terminal  function  key  7 

k8 

str 

Sent  by  terminal  function  key  8 

k9 

str 

Sent  by  terminal  function  key  9 

11 

str 

Label  on  function  key  1 

12 

str 

Label  on  function  key  2 

13 

str 

Label  on  function  key  3 

14 

str 

Label  on  function  key  4 

15 

str 

Label  on  function  key  5 

16 

str 

Label  on  function  key  6 

17 

str 

Label  on  function  key  7 

18 

str 

Label  on  function  key  8 

19 

str 

Label  on  function  key  9 

kd 

str 

Sent  by  terminal  down  arrow  key 

kl 

str 

Sent  by  terminal  left  arrow  key 

kr 

str 

Sent  by  terminal  right  arrow  key 

ku 

str 

Sent  by  terminal  up  arrow  key 

li 

num 

Number  of  lines  on  screen  or  page 

nl 

str 

(p) 

Newline  character  (default  \n) 

se 

str 

End  stand  out  mode 

sf 

str 

(p) 

Scroll  forwards 

so 

str 

Begin  stand  out  mode 

sr 

str 

(p) 

Scroll  reverse  (backwards) 

su 

bool 

Scrolls  up  at  bottom  of  screen 
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to 

str 

Sent  by 

terminal 

f unct ion 

key 

30 

tl 

st  r 

Sent  by 

terminal 

f unct ion 

key 

31 

t2 

str 

Sent  by 

terminal 

f unct ion 

key 

32 

v0 

str 

Label  on 

f unct ion 

key  30 

vl 

str 

Label  on 

f unct ion 

key  3 1 

v2 

str 

Label  on 

f unct ion 

key  3  2 

wr 

bool 

Wraps  at 

end  of  line 

xO 

str 

Sent  by 

terminal 

i unct ion 

key 

10 

xl 

str 

Sent  by 

terminal 

f unct ion 

key 

11 

x2 

str 

Sent  by 

terminal 

f unct ion 

key 

12 

x3 

str 

Sent  by 

terminal 

f unct ion 

key 

13 

x4 

str 

Sent  by 

terminal 

funct ion 

key 

14 

x5 

str 

Sent  by 

terminal 

f unct ion 

key 

15 

xb 

str 

Sent  by 

terminal 

funct ion 

key 

16 

x7 

str 

Sent  by 

terminal 

function 

key 

17 

x8 

str 

Sent  by 

terminal 

funct ion 

key 

18 

x9 

str 

Sent  by 

terminal 

funct ion 

key 

19 

yO 

str 

Label  on 

f unct ion 

key  10 

yi 

str 

Label  on 

f unct ion 

key  11 

y2 

str 

Label  on 

f unct ion 

key  12 

y3 

str 

Label  on 

f unct ion 

key  13 

y4 

str 

Label  on 

f unct ion 

key  14 

y5 

str 

Label  on 

f unct ion 

key  15 

y6 

str 

Label  on 

f unct ion 

key  16 

y7 

str 

Label  on 

f unct ion 

key  1 7 

y8 

str 

Label  on 

f unct ion 

key  18 

y9 

str 

Label  on 

f unct ion 

key  19 

is  obvious  from  this 

list  that 

there  a 

re  three  basic 

terminal  capability  fields:  Boolean  capabilities  which  indicate  that 
the  terminal  has  some  particular  feature,  numeric  capabilities  giving 
the  size  of  the  terminal  or  the  size  of  particular  delays,  and  string 
capabilities,  which  give  a  sequence  which  can  be  used  to  perform 
particular  terminal  operations.  Note  that  these  2  letter  codes  may 
appear  in  any  order  within  a  temrinai's  1CF  eutiy. 

Numeric  capabilities  are  followed  by  the  character  "#"  and  then  the 
value.  Thus  "co"  which  indicates  the  number  of  columns  the  terminal 
has  gives  the  value  "80"  for  the  Televideo-970. 

String  valued  capabilities,  such  as  "ce"  (clear  to  end  of  line 
sequence)  are  given  by  the  two  character  code,  an  "=",  and  then  a 
string  ending  at  the  next  following  A  delay  in  milliseconds  may 
appear  after  the  "=”  in  such  a  capability.  The  delay  must  be  an 
integer,  e.g.  "20". 

A  number  of  escape  seauences  are  provided  in  the  string  valued 
capabilities  for  easy  encoding  of  characters  there.  A  "\E"  maps  to  an 
ESCAPE  character,  "~x"  maps  to  a  control-x  for  any  appropriate  x,  and 
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the  sequences  "\n"  ”\r"  "\t"  "\b"  "\f"  give  a  newline,  return,  tab, 

backspace  and  form-feed  respectively.  Finally,  characters  may  be 
given  as  three  octal  digits  after  a  ,  and  the  characters  and 

"\"  may  be  given  as  and  If  it  is  necessary  to  place  a 

in  a  capability  it  must  be  escaped  in  octal  as  "\072". 

5. 2. 3. 4  Content 

The  Terminal  Capabilities  File  is  an  ADE  database  file  which  contains 
mappings  from  logical  computer  terminal  characteristics  to  specific 
computer  terminal  characteristics.  Typically,  the  TCF  contains 
information  that  supports  many  different  terminal  types  and  makes. 
The  following  Terminal  Capabilities  File  entry  describes  the 
capabilities  of  a  Televideo-970: 

tl I tv970 ! tv-970  I  televideo  970:\ 

:al=l\E[lL:cd=\E[J:ce=\E[K: cm=\E[ %i%2;%2H:co#80:\ 
:dc=\E[lP:dl=l*\E[ lM:ei=\E[4l:im=\E[4h:li#24:\ 

: se=\E[ Om: so=\E[ 7m: \ 

: kb=~h : ku=\E[ A: kd=\E[B:kl=\E[D:kr=\E[C:\ 

:kl=\E?a\014: ll=Fl:k2=\E?b\014: 12=F2:\ 

:k3=\E?c\014: 13=F3 : k4=\E?d\0 14 : 14=F4 : k5=\E?e\ 0 14 : 15=F5:\ 
:k6=\E?f\014:16=F6:k7=\E?g\014 : 17=F7 : k8=\E?h\014 : 17=F7 : \ 
:k9=\E?i\014:19  =  F9:x0  =  \E?j\014:y0  =  F10:xl  =  \E?k\014:yl  =  FH:\ 
:x2=\E?l\014:y2=F12: x3=\E?m\0 14 :y3=F13:x4=\E?n\014:y4-F14:\ 
:x5=\E?o\014:y5=F15:x6=\E?p\014:y6=F16:\ 

: sr=\EM : i s  =  \E<\E[ > 1 ; 2 ; 3 ; 4 ; 5 ; 6 ; 7 ; 8 ; 9 1\E [ Om\E [ 1 lm\E [ ?7  h : \ 
:be=\E[?5h\E[?51: 


5.2.4  AIM  Help  File 

5. 2. 4.1  Purpose  And  Use 

During  the  execution  of  the  AIM,  the  user  may  request  on-line  help  for 
AIM  related  topics.  The  information  supporting  on-line  Help  is 
contained  in  the  AIM's  help  file. 

5. 2. 4. 2  Input  Media 

The  AIM  Help  File  is  stored  in  an  ADE  database  file  named 
AIM_HELP_F I LE . 

5. 2. 4. 3  Format 

The  text  file  used  by  the  HELP_UTILITY  Package  is  required  to  have  a 
particular  format.  If  the  file  is  not  in  this  format,  an  exception 
will  be  raised.  The  following  explains  the  required  format. 

COMMENTS:  Comments  may  be  embeded  in  the  text  file.  All  comments  are 


5-7 


AIM  OPERATING  INSTRUCTIONS 
AIM  Help  Pile 

ignored  when  the  file 
a  comment  if  the  first 
s igns  (  --  )  . 

TOPICS:  The  first  non-comment  text  line  MUST  begin  w;t  n  t'~e 

in  column  one.  This  number  is  the  topic  level.  In.  ot.ner  woris, 

( as  defined  below)  cannot  be  found  in  the  Help  file  oefore  a  topic 
found  to  which  the  text  can  be  associated.  Topics  are  t nose  sucq  eo* 
for  which  information  is  being  provided.  A  topic  name  may  contain  an 
printable  character  except  blanks.  Embedded  blanks  are  NOT  avowee  i 
a  topic  name.  This  will  not  be  flagged  as  an  error  but  the  full  cam 
will  not  be  recognized  within  the  AIM.  All  letters  :n  the  name  mus 
be  capitals.  It  is  not  required  to  have  a  space  separating  tne  topi 
level  from  the  topic  name.  Any  line  beginning  with  a  digit  wu.  o 
considered  3  topic  line. 

SUBTOPICS:  A  topic  may  have  subtopics.  Subtopics  are  denoted  b 

having  a  level  exactly  one  greater  than  the  associated  topic  leve. 
Subtopics  follow  the  same  rules  as  topics  in  all  other  aspects.  Tr.er 
is  no  constraint  (other  than  a  lack  of  memory)  on  the  numner  c 
subtopic  levels  ( i . e. --subtopics  may  have  sub topics). 

TEXT:  All  text  lines  not  beginning  with  two  consecutive  minus  sign 

or  a  digit  will  be  considered  text. 


The  text  file  is  saved 
lines:  with  the  follow 

exactly  as 
except  ions : 

the  user  sees 

i 

(  i  n  c  1  ud  i  n  g  b  1  a  n 

o  topic  and  subtopic 

names  have 

leading  blanks 

st  r 

i peed  off. 

o  if  the  topic  or  subtopic  name 

is  longer  than 

one 

half  the  scree 

size,  it  may  be  truncated  when  a  menu  of  information  is  output, 


o  if  the  text  line  is  longer  than  the  screen  size,  tne  text  line 
truncated  before  output,  and 

o  the  text  file  lines  are  assumed  to  be  eighty  characters  maximum. 


5 . 2 . 4 . 4  Content 

The  AIM  Help  file  contains  help  messages  for  all  AIM  related  t  op  i  :s 
A  brief  sample  of  the  Help  file's  overall  content  follows: 

1  ASSOCIATE 

The  ASSOCIATE  command  maps  a  specified  portion  of  a  window  ont 
image.  Assuming  that  n  -  <length>  and  p  =  ^position-'  the  ASSC 
command  maps  the  last  n  lines  of  the  specified  window  onto  the  g 
image  starting  at  the  pth  line  of  the  image.  For  example. 


is  read  into  memory, 
and  second  characters 


A  -.ext  line 


o  r 


t  ne 


;  c  r.  s  ice  r* 
are  m ;  .o 


o  :J 


AIM 


OPERATING 


N STRUCT  I  CNS 
M  Help  File 


ASSOC  WIN_1  I M_ 1  13  12 

will  map  the  last  12  lines  of  WIN_1  onto  lines  13.. 24  of  IM_1.  '"’his 
forms  an  abstract  association  between  WIN_1  and  IM_1  by  creating  a 
viewport  (lines  13  thru  24)  onto  which  the  last  12  lines  of  WIN_1  are 
mapped.  This  viewport  partitions  the  image  vertically,  and  its  width 
is  equal  to  the  width  of  the  image. 

Note:  A  window  may  be  associated  with  more  than  one  image  at  the 

same  time;  however,  a  specific  window  may  only  be  associated 
with  a  specific  image  once. 

2  SYNTAX 

AS*SOCI ATE  WINDOW_NAME  =>  <w i ndow_name > 

IMAGE_NAME  =>  < image  name> 

TOP  =>  <posit7on> 

LENGTH  =>  <lengtn> 

2  COMMAND_PARAMETERS 

WINDOW_NAME  =>  <w i ndow_name> 

Specifies  the  window  whose  last  <length>  lines  are  to  be  mapped 
onto  the  specified  image. 

IMAGE_NAME  =>  <image_name> 

Specifies  the  image  onto  which  a  portion  of  the  given  window 
will  be  mapped. 

TOP  =>  <position- 

Specifies  the  starting  position  for  the  association  relative  to 
the  top  of  the  specified  image. 

LENGTH  =>  < length> 

Specifies  the  length  of  the  viewport  used  for  the  requested 
association.  In  addition  to  the  viewport  header,  at  least  one 
line  of  a  window  must  be  displayed  in  a  viewport;  therefore, 
the  minimum  length  allowable  is  2. 

2  EXAMPLES 

Long  Form:  AIM>  ASSOCIATE  WINDOW__NAME  =>  W_1 

IMAGE_NAME  =>  I_1 
TOP  =>  1 
LENGTH  =>  24 

Associate  the  entire  contents  of  window  W_1  with  the  image  I_l. 

Mixed  Form:  AIM>  ASSOC  WIN_2  IMAGE_NAME  =>  IM_2  1  LENGTH  =>  8 

Associate  the  last  8  lines  of  window  WIN_2  with  the  first  8  lines 
of  image  IM_1. 
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Short  Form:  AIM>  AS  WIN_3  IM_3  9  8 

Associate  the  last  8  lines  of  window  WIN_3  with  lines  9  thru  16 
of  image  IM_1. 

2  ERRORS 

The  semantic  errors  associated  with  this  command  include: 

"Window  <wi ndow_name>  does  not  exist" 

The  specified  window  name,  <window_name>  does  NOT  exist  (i.e.--  no 
window  of  that  name  has  been  created) . 

"Image  <image_name>  does  not  exist" 

The  specified  image  name,  <image_name>  does  NOT  exist  (i.e.--  no 
image  of  that  name  has  been  created) . 

"Invalid  length:  <length>" 

The  specified  viewport  length  was  either  out  of  range,  non-numeric 
or  too  long  to  ensure  non- intersect ing  viewports  of  the  given  imag 

"Invalid  top  line:  <top_line>" 

The  specified  top  line  for  starting  the  viewport  was  either  out  of 
range,  or  non-numeric. 

"Association  between  specified  window  and  image  already  exists" 

The  specified  window  is  currently  associated  with  <image_name>  and 
the  AIM  prohibits  multiple  associations  between  the  same 
window  and  image. 

"Cannot  map  another  window-  onto  the  AIM  image” 

The  AIM  image  and  window  cannot  be  altered  by  the  user. 

5.2.5  AIM  Parse  Table  File 

5.2.5. 1  Purpose  And  Use 

The  AIM  Parse  Table  File  is  used  by  the  AIM's  command  line  interpreter 
(CLI)  to  parse  incoming  AIM  textual  commands.  These  LALR  parse  tables 
are  read  in  by  the  AIM's  CLI  during  initialization  and  used  by  the  AIM 
parser  throughout  the  AIM's  execution. 

5. 2. 5. 2  Input  Media 

The  AIM  Parse  Table  File  is  stored  in  an  ADE  database  file  named 
AIM  PARSE  TABLE  FILE. 
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5. 2. 5. 3  Format 

A  description  of  the  LALR  parsing  tables  extracted  from  the  NYU  LALR 
Parser  Generator  User's  Manual  [NYU81]  follows. 

The  LALR  Parse  Table  file  contains  the  following  8  objects: 

(1)  Map  of  symbols  used  in  the  grammar.  (NOSYM) 

(2)  Tuple  of  left  hand  side  symbol.  (LHS) 

(3)  Tuple  of  size  of  right  hand  sides.  (RHS) 

(4)  Action  table  1.  (see  below) 

(5)  Action  table  2.  (see  below) 

(6)  Tuple  of  default  reductions.  (DEFAULT) 

(7)  Tuple  of  symbols  on  which  shifts  were  made  to  branch  into 
a  new  state.  (IN_SYM) 

(8)  Follow  map.  (FOLLOW) 

The  first  line  of  the  output  file  contains  the  size  of  the  8  objects 
together  with  some  constants  needed  to  parse  a  source  input.  The  format 
is  1216.  and  the  fields  are: 

(1)  Number  of  symbols. 

(2)  Number  of  left  hand  sides. 

(3)  Number  of  right  hand  side  sizes. 

(4)  Number  of  entries  in  Action  Table  1. 

(5)  Number  of  entries  in  Action  Table  2. 

(6)  Number  of  entries  in  Default  tuple. 

(7)  Number  of  entries  in  IN_SYM. 

(8)  Number  of  entries  in  follow  map. 

(9)  Number  of  States  +  1.  ( NUM_STATES ) 

(10)  Number  of  symbols  ♦  1.  (NUM_ INPUTS) 

(11)  Number  of  Actions.  ( NUM_ACTIONS ) 

(12)  Table  size.  ( TABLE_S IZE ) 

The  encoding  of  the  objects  is  as  follows: 

(1)  NOSYM  map:  (14,  12,  64A1)  format. 

The  three  fields  are: 

a)  Numeric  value  assigned  to  the  symbol 

b)  size  of  the  string  representing  the  symbol 

c)  the  string  representing  the  symbol 

(2,6,7)  LHS,  DEFAULT,  and  IN_SYM  tuples:  1814  format 
(3)  RHS  tuple  :  3612  format. 

(4,5)  ACTI0N_TABLE1  and  ACT I ON_T AB L E 2  tuples:  918  format 

(8)  FOLLOW  map:  1814  format.  Each  entry  in  the  map  begins  on 

a  new  line.  The  first  value  is  the  domain  value, 
the  second  is  the  size  of  the  range  value(which  is  a  set) 
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and  the  remaining  values  are  the  elements  in  this  set.  If 
there  are  more  than  16  elements  in  the  set,  they  are 
printed  on  successive  lines. 


Each  object  begins  on  a  new  line.  Thus  at  the  end  of  an  object,  the 
last  line  may  not  be  filled  up. 

5. 2. 5. 4  Content 

Given  the  following  simple  grammar  specification: 

1  E  :  :  =  E  +  T 

2  E  :  :  =  T 

3  T  :  :  =  T  *  F 

4  T  :  :  =  F 

5  F  :  :  =  (  E  ) 

6  F  : ID 


the 

LALR 

Parser  < 

Oenerator 

produces 

the  fol 

lowing  as 

its 

pa 

rse  table 

file 

• 

11 

6 

6 

43 

43 

12 

12 

4 

13 

12 

21 

37 

1 

0 

2 

1  + 

3 

1* 

4 

1( 

5 

1) 

6 

2  ID 

7 

45EOF 

8 

4$  ACC 

9 

IE 

' 

10 

IT 

11 

IF 

9 

9 

10 

10 

11 

11 

3  1 

3  1 

3  1 

0 

55 

0 

61 

0 

4 

0 

0 

58 

6 

2 

0 

8 

0 

0 

10 

3 

0 

4 

0 

0 

5 

6 

2 

9 

8 

0 

0 

4 

0 

13 

0 

11 

2 

3 

9 

0 

12 

7 

0 

4 

3 

0 

0 

0 

0 

0 

0 

42 

0 

0 

0 

46 

47 

0 

86 

0 

0 

89 

16 

0 

18 

0 

0 

21 

22 

23 

135 

62 

100 

0 

102 

0 

67 

0 

106 

107 

112 

<— 

/ 

0 

119 

45 

0 

114 

40 

0 

0 

17 

0 

19 

0 

15 

0  0 

0 

18 

14  16 

1 

11 

4 

6 

9 

10 

9  2 

3 

5 

10  11 

8  17 

9  3  2  5  7 
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10  4  2  3  5  7 

11  4  2  3  5  7 

5.2.6  AIM  Initialization  Script  File 

5. 2. 6.1  Purpose  And  Use 

Upon  invocation,  the  AIM  attempts  to  open  and  read  a  pre-defined 
initialization  script  file.  If  the  file  exists,  the  AIM  command 
interpreter  sets  the  AIM  window  to  be  the  currently  active  window,  and 
then  reads  and  executes  the  commands  present  in  the  file;  otherwise, 
the  AIM  CLI  sets  the  MAIN  window  to  be  the  currently  active  window. 

5. 2. 6. 2  Input  Media 

T.ne  AIM  initialization  script  file  is  stored  in  an  ADE  database  file 
named  AIM_INIT_SCRI PT_F I LE . 

5 . 2 . 6 . 3  Format 

The  AIM  initialization  script  file  is  an  ASCII  text  file  of  AIM 
textual  commands. 

5. 2. 6. 4  Content 

The  AIM  initialization  script  file  contains  AIM  textual  command  lines. 
For  example; 

DEFINE  TERMINAL  "TV970" 

RESET  AIM_SUSPENDS 
RESET  FULL  AIM 
RESET  FULL  MAIN 

This  initialization  script  file  defines  the  terminal  to  be  a  TeleVideo 
970  and  also  resets  various  AIM  flags. 

5.2.7  User  Defined  Script  Files 

5. 2. 7.1  Purpose  And  Use 

During  the  execution  of  the  AIM  program  a  user  may  use  the  AIM 
"SCRIPT"  command  to  read  and  interpret  a  group  of  AIM  commands  from  a 
text  file.  Using  AIM  script  files  provides  a  quick  mechanism  for 
re-creating  frequently  used  window/image  scenarios. 

5. 2. 7. 2  Input  Media 

An  AIM  script  file  is  stored  in  ADE  database  file  whose  name  is 
defined  by  the  user  and  is  not  to  exceed  20  charcaters  in  length. 
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5. 2. 7. 3  Format 


An  AIM  script  file  is  an  ASCII  text  file  of  AIM 

textual 

commands . 

5. 2. 7.4  Content 

An  AIM  script  file  c 

on tains  AIM  t 

extual  command 

1 ines . 

For 

ex amp  1 e : 

CREATE 

IMAGE 

IMAGE  1 

CREATE 

IMAGE 

IMAGE  2 

CREATE 

WINDOW 

WINDOW  A 

CREATE 

WINDOW 

WINDOW  3 

CREATE 

WINDOW 

WINDOW  C 

CREATE 

WINDOW 

WINDOW  D 

ASSOC 

WINDOW  A 

IMAGE  1  1 

8 

ASSOC 

WINDOW  B 

IMAGE  1  9 

8 

ASSOC 

WINDOW  C 

IMAGE  1  17 

8 

ASSOC 

WINDOW  C 

IMAGE  2  1 

12 

ASSOC 

WINDOW  D 

IMAGE_2  13 

12 

This  AIM  script  file 

creates  two 

images  and  four  windows, 

and  then 

maps  these 

windows  onto  the  given 

images . 

5.3  AIM  OUTPUTS 


The  AIM  has  three  areas  where  output  is  generated: 

1.  Terminal  Output, 

2.  Input  Pad  Files,  and 

3.  Output  Pad  Files. 

A  discussion  of  each  follows. 

5.3.1  Terminal  Output 

5. 3.1.1  Purpose  And  Use 

The  AIM  generates  terminal  output  in  response  to  the  interpretation  of 
AIM  commands,  and  as  a  direct  result  of  executing  the  users  ADE 
programs. 

5 . 3 . 1 . 2  Output  Med i a 

The  AIM  generates  interactive  output  to  the  user's  terminal.. 

5. 3. 1.3  Format 

The  AIM  output  to  the  user's  terminal  is  a  stream  of  characters. 
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5. 3. 1.4  Content 

The  terminal  output  generated  by  the  AIM  includes:  output  from  the 

AIM's  command  interpreter ( Command  Prompts,  On-line  Help  information, 
AIM  Environmental  Information,  Error  Messages),  and  output  from  ADE 
programs . 

5.3.2  Input  Pad  Files 

5.3.2. 1  Purpose  And  Use 

An  AIM  user  can  at  any  time  request  the  activation  of  a  window's  input 
pad.  Each  activation  of  an  input  pad  creates  a  unique  ADE  database 
file.  When  a  window’s  input  pad  is  active,  all  input  destined  for  the 
particular  window  is  also  written  to  the  corresponding  input  pad  file. 

5. 3. 2. 2  Output  Media 

An  AIM  input  pad  is  stored  in  an  ADE  database  file. 

5 . 3 . 2 . 3  Format 

An  AIM  input  pad  file  is  an  ASCII  text  file. 

5. 3. 2. 4  Content 

An  AIM  input  pad  for  a  window  named  X  contains  all  the  input  destined 
for  X  during  the  time  period  that  the  input  pad  was  active. 

5.3.3  Output  Pad  Files 

5. 3. 3.1  Purpose  And  Use 

An  AIM  user  can  at  any  time  request  the  activation  of  a  window's 
output  pad.  Each  activation  of  an  output  pad  creates  a  unique  ADE 
database  file.  When  a  window's  output  pad  is  active,  all  output 
destined  for  the  particular  window  is  also  written  to  the 
corresponding  output  pad  file. 

5. 3. 3. 2  Output  Media 

An  AIM  output  pad  is  stored  in  an  ADE  database  file. 

5. 3. 3. 3  Format 

An  AIM  output  pad  file  is  an  ASCII  text  file. 

5. 3. 3. 4  Content 

An  AIM  output  pad  for  a  window  named  X  contains  all  the  output 
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Output  Pad  Files 

destined  for  X  during  the  time  period  that  the  output  pad  was  active. 
5.3.4  AIM  Input-Output  Diagram 

An  overall  Input-Output  Diagram  of  the  AIM  is  shown  in  the  following 
f igure. 

Keyboard  Input  - > 

Terminal  Identification  -> 

File  (TERM) 

Terminal  Capabilities  - > 

File  ( TCF ) 

Command  Script  - > 

File(s) 

HELP  file  > 

AIM  Parse  > 

Table  File 


INPUT  OUTPUT 

Figure  5.1--AIM  Input-Output  Diagram 
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PAGE  TERMINAL  TUTORIAL 

The  following  are  sample  AIM  sessions.  Each  is  independently  complete 
in  that  it  assumes  nothing  about  the  prior  AIM  context.  The  AIM  is 
invoked  at  the  beginning  of  each  session,  and  subsequently  exited  at 
the  end  of  each  session. 

Session  Assumptions: 

1.  Data  General  Corporation’s  Ada  Development  Environment 

2.  a  Page  terminal 

3.  terminal  display  with  24  lines  and  80  character  columns 

For  the  reader's  convenience,  the  following  conventions  will  be  used 
in  the  presentation  of  this  session: 

1.  ALL  user  responses  will  appear  on  the  last  nonblank  line  of  the 
screen 

2.  the  affect  of  executing  a  user's  command  will  be  presented  in  the 
next  screen  relative  to  when  the  command  was  issued 

3.  the  comments  below  each  screen  will  explain: 

a.  the  affect  of  executing  the  previous  AIM  command 

b.  the  contents  of  the  current  screen 

c.  the  new  AIM  command  issued  at  the  bottom  of  the  present  screen 
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The  default  key  sequences  that  exist  when  the  AIM  is  invoked 
ASCII  Page  Mode  Terminal  are  as  follows: 

DEFAULT  KEYSTROKES 


ABORT_SCR  I PT . FI 

CLEAR_W  I NDOW . F2 

NEXT  IMAGE . F3 

NEXTPAGE . F4 

NEXT  VIEWPORT . F5 

PREVIOUS.  IMAGE . F6 

PREV I  OUS_V  I EWPCRT . F7 

RED  I  SPLAY_SCREEN . F8 

RETURN_TO_PREV  I  OUS_  I  MAGE . F9 

SWITCH  TO  AIM . F10 


where  "F#"  represents  a  function  key. 


f  rom  a 
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A. 1  SESSION  1  -  BASIC  AIM  COMMANDS 

The  following  AIM  command  session  demonstrates  the  use 
commands,  including: 

*  CREATE 

*  ASSOCIATE 

*  GOTO 

*  DELETE 

*  DISASSOCIATE 


PAGE  TERMINAL  TUTORIAL 
1  -  BASIC  AIM  COMMANDS 


of  some  basic  AIM 


EXIT 


PAGE  TERMINAL  TUTORIAL 
SESSION  1  -  BASIC  AIM  COMMANDS 


INVOKE  AIM  FROM  APSE 

)  AIM 


BOTTOM- OF- SCREEN 


Comments : 

Command:  AIM  -  invoke  the  AIM  from  the  APSE. 
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MAIN  MAIN 

AOS/VS  CLI  REV  05.01.00.00 


SWITCH  TO  AIM  IMAGE 
FRCH: 016  Running 

9- APR-8  5  13:  26:43 


{ F10 } 


AF 


BOTTOM-OF-SCREEN 


Comments:  The  AIM  initializes  the  current  image  to  be  MAIN.  To  enter  AIM 
textual  commands  the  user  must  communicate  through  the  AIM  window  to  the 
AIM  command  interpreter. 

Command:  {FIG}  -  Set  the  current  image  to  be  the  AIM  image. 
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CREATE  A  NEW  IMAGE 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT  TYPE  =>  IMAGE  IMAGE  NAME  =>  IMAGE  1 


_ BOTTOM-OF-SCREEN _ 

Comments:  The  AIM  Command  Interpreter  is  awaiting  input  from  the  terminal 

Command:  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1  -  Create  a 

image  named  IMAGE  1. 
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CREATE  A  NEW  WINDOW 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT  TYPE  =>  WINDOW  WINDOW  NAME  =>  WINDOW  A 


BOTTOM-OF- SCREEN 


Comments:  The  AIM  Command  Interpreter  has  created  a  new  image  named 

IMAGE_1. 

Command:  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_NAME  =>  WINDOW_A  -  Create  a 

window  named  WINDOW  A. 
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CREATE  A  NEW  WINDOW 


AIM 

AIM>  CREATE 
AIM>  CREATE 
AIM>  CREATE 


AIM  AIM  CLI  Running 

OBJ  ECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WINDOW_A 
OBJECT  TYPE  =>  WINDOW  WINDOW  B 


AF 


BOTTOM-OF-SCREEN 


Comments:  The  AIM  Command  Interpreter  has  created  a  new  window  named 

WINDOW_A. 

Command:  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B  -  Create  a  window  named 

WINDOW  B. 
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CREATE  A  NEW  WINDOW 


AIM  AIM  AIM  CLI  Running 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_NAME  =>  WINDOW_A 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDOW  C 


BOTTOM-OF- SCREEN 


omments:  The  AIM  Command  Interpreter  has  created  a  new  window 

INDOW_B. 

Command:  CR  WINDOW  WINDOW  C  -  Create  a  window  named  WINDOW  C. 
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TUTORIAL 

COMMANDS 


AF 


named 
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ASSOCIATE  WINDOW  A  WITH  IMAGE  1 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_I 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_NAME  =>  WINDOW_A 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDOW_C 
AIM>  ASSOC  WINDOW  A  IMAGE  118 


BOTTOM-OF- SCREEN 


Comments:  The  AIM  Command  Interpreter  has  created  a  new  window  name 

WINDOW_C. 

Command:  ASSOC  WINDOW__A  IMAGE_1  1  8  -  Map  the  last  8  lines  of  WINDCW_ 

onto  the  first  8  lines  of  IMAGE  1. 


4 
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ASSOCIATE  WINDOW_B  WITH  IMAGE_1 

AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_NAME  =>  WINDOW_A 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDOW_C 
AIM>  ASSOC  WINDOW_A  IMAGE_1  1  8 
AIM>  ASSOC  WINDOW  B  IMAGE  198 


BOTTOM-OF-SCREEN 


Comments 

:  The  last  8 

lines  of 

W I NDOW_ A  are  associated 

with 

the 

f  i  rst 

8 

lines  of 

IMAGE_1 . 

Command : 

ASSOC  WINDOW 

B 

IMAGE_ 

1  9  8  -  Map  the  last  8 

1  ines 

of 

W I NDOW_ 

_B 

onto  the 

middle(9. .16) 

8 

1  ines" 

"of  IMAGE_1. 
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SESsroN  :  -  basic  aim  commands 


ASSOCIATE  WINDOW  C  WITH  IMAGE  1 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  *>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WINDOW_A 
AIM>  CREATE  OBJECT_TYPE  *>  WINDOW  WINDOW__B 
AIM>  CR  WINDOW  WINDOW_C 
AIM>  ASSOC  W I NDCW_A  IMAGE_1  1  8 
AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 
AIM>  ASSOC  WINDOW  C  IMAGE  1  17  8 


BOTTOM- OFFSCREEN 


Comments:  WIND0W_A  and  WIND0W_B  are  currently  mapped  onto  IMAGE_1. 

Command:  ASSOC  WINDOW_C  IMAGE_1  17  8  -  Map  the  last  8  lines  of  WINDCW_C 

onto  the  last(17..24)  8  lines  of  IMAGE  1. 
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GOTO  IMAGE  IMAGE  1 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WINDOW_A 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDOW_C 
AIM>  ASSOC  WINDOW_A  IMAGE_1  1  8 
AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 
AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 
AIM>  GOTO  IMAGE  IMAGE  1 


BOTTOM-OF - SCREEN 


Comments:  WIND0W_A,  WINDOW_B,  and  WINDOW_C  are  currently  mapped  onto 

IMAGE_1. 

Command:  GOTO  IMAGE  IMAGE_1  -  Position  the  cursor  in  the  top  viewport  of 

IMAGE  1. 


u  > 
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SESSION  1  -  BAS 

'JTOR  I  AL 

IC  AIM  COMMANDS 

CURRENT 

IMAGE  ON  SCREEN 

IS  IMAGE_1 

IMAGE_1 

W I NDOW_ A 

FRCH : 0 1 7 

Running 

AF 

AOS/VS  CL  I 

REV  05.01.00.00 

1 1 -APR-8  5 

8:55:29  { FI 0 } 

IMAGE_1 

WINDOW_B 

FRCH: 018 

Runn i ng 

AF 

aos/vs  cl: 

REV  05.01.00.00 

1 l-APR-85 

8:55:29 

IMAGE_1 

W I NDOW_C 

FRCH: 019 

Running 

AF 

AOS/VS  CL I 

REV  05.01.00.00 

1 l-APR-85 

8:55:29 

BOTTOM - 0  F - SCREEN 


Comments:  The  cursor  was  positioned  in  the  first  viewport  of  IMAGE_i. 
Each  window  is  executing  its  own  APSE  process,  namely  the  APSE  command 
interpreter;  thus,  the  APSE  command  interpreter  prompt,  ")",  appears  in 
WINDOW_A,  WINDOW  B,  and  WINDOW^C.  Note,  each  viewport  header  displays  the 
default  flag  settings  for  the  windows  ("AF"). 

Command:  {F10}  -  Switch  control  back  to  the  AIM  command  interpreter  in  the 
AIM  window. 
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GOTO  WINDOW  WINDOW  C 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJ ECT_T YPE  =>  WINDOW  W I NDOW_NAME  =>  WINDOW_A 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDOW_C 
AIM>  ASSOC  W I NDOW_A  IMAGE_1  1  8 
AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 
AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  GOTO  WINDOW  WINDOW  C 


BOTTOM-OF-SCREEN 


Comments:  Control  has  returned  to  the  AIM  command  interpreter. 

Command:  GOTO  WINDOW  WINDOW_C  -  Position  the  cursor  in  the  largest 

viewport  associated  with  WINDOW_C. 


A- 15 


PAGE  TERMINAL  TUTORIAL 
SESSION  1  -  SASIC  AIM  COMMANDS 


IMAGE_1 
AOS/VS  CL  I 


CURRENT  IMAGE  ON  SCREEN  IS  IMAGE  1 


WINDOW_A 
REV  05.01.00.00 


FRCH : 0 1 7  Suspended 

1 1- APR-85  8:55:29 


IMAGE_1 
AOS/VS  CL  I 


WINDOW_B 
REV  05.01.00.00 


FRCH: 019 


Suspended 


ll-APR-85  8:55:29 


IMAGE_1 
AOS /VS  CL I 


WINDOW_C 
REV  05.01.00.00 


FRCH: 019 

ll-APR-85 


Suspended 

8:55:29  { FI  0  > 


BOTTOM -OF -SCREEN 


Comments:  Tne  cuisor  was  positioned  in  the  third  viewport  of  IMAGE 
it  was  the  largest  -one  associated  with  WlNDOW_C.  Note  that  the 
flag  is  set,  this  was  caused  by  the  Switch-to-Aim  keystroke. 

Command:  { F 1 0 }  Switch  control  back  to  the  AIM  command  interpreter 
AIM  window. 


AFS 

AFS 

AFS 


1  since 
suspend 

in  the 


I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 
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DISASSOCIATE  WINDOW  A  AND  IMAGE  1 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  W I NDOW_N AME  =>  WINDOW_A 
AIM>  CREATE  C3JECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDOW_C 
AIM>  ASSOC  W I NDOW_ A  IMAGE_1  I  8 
AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 
AIM>  assoc  WINDOW_C  IMAGE_1  17  8 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  GOTO  WINDOW  WINDOW_C 
AIM>  DIS  WINDOW  A  IMAGE  1 


BOTTOM-OF-SCREEN 


Comments:  Control  has  returned  to  the  AIM  command  interpreter. 

Command:  DIS  WIND0W_A  IMAGE_1  -  "DIS"  is  a  valid  abbreviation  for  the 
DISASSOCIATE  command;  this  command  instructs  the  AIM  command  interpreter  to 
break  the  logical  association  between  WINDOW_A  and  IMAGE_1. 
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DISASSOCIATE  WINDOW  B  AND  IMAGE  1 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =  >  WINDOW_A 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDCW_C 
AIM>  ASSOC  W I NDOW_ A  IMAGE_1  1  8 
AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 
AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  GOTO  WINDOW  WINDOW_C 
AIM>  DIS  W I NDCW_ A  IMAGE  1 
AIM>  DIS  WINDOW  B  IMAGE_1 


BOTTOM-CF-SCREEN 


Comments:  The  logical  association  between  WIND0W_A  and  IMAGE_1  has  bee 

dissolved. 

Command:  DIS  WINDOW_B  IMAGE__1  -  Break  the  logical  association  betwee 

WINDOW  B  and  IMAGE  1. 
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DISASSOCIATE  WINDOW  C  AND  IMAGE  1 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_NAME  =>  WINDOW_A 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDOW_C 
AIM>  ASSOC  W I NDOW_ A  IMAGE_1  1  8 
AIM>  ASSOC  W I NDOW_B  IMAGE_1  9  8 
AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  GOTO  WINDOW  WINDOW_C 
A IM>  DIS  WINDOW_A  IMAGE_1 
AIM>  DIS  WINDOW_B  IMAGE_1 
AIM>  DIS  WINDOW  C  IMAGE  1 


BOTTOM-OF-SCREEN 


Comments:  The  logical  association  between  WINDOW_B  and  IMAGE_1  has  been 

dissolved.  ~ 

Command:  DIS  WIND0W_C  IMAGE_1  -  Break  the  logical  association  between 

WINDOW  C  and  IMAGE  1. 
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DELETE  WINDOW  WINDOW  A 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_NAME  =>  WINDOW_A 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDOW_C 
AIM>  ASSOC  WINDOW_A  IMAGE_1  1  8 
AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 
AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  GOTO  WINDOW  WINDOW_C 
AIM>  DIS  W I NDCW_ A  IMAGE_1 
AIM>  DIS  WINDOW_B  IMAGE_1 
AIM>  DIS  WINDOW_C  IMAGE_1 
AIM>  DEL  WINDOW  WINDOW  A 


BOTTOM-OF-SCREEN 


Comments:  The  logical  association  between  WINDOW_C  and  IMAGE_1  has  bee 
dissolved. 

Command:  DEL  WINDOW  WINDOW_A  -  "DEL"  is  a  valid  abbreviation  for  the  AI 
delete  command.  This  command  instructs  the  AIM  command  interpreter  t 
remove  WINDOW  A  from  the  internal  list  of  windows  in  the  AIM  environment. 
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DELETE  WINDOW  WINDOW  B 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_NAME  =>  WINDOW_A 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDOW_C 
AIM>  ASSOC  W I NDOW_A  IMAGE_1  1  8 
AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 
AIM>  ASSOC  WINDOW_C  IMAGE_I  17  8 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  GOTO  WINDOW  WINDOW_C 
AIM>  DIS  WINDOW_A  IMAGE_1 
AIM>  DIS  WINDOW_B  IMAGE_1 
AIM>  DIS  WINDOW_C  IMAGE_1 
A1M>  DEL  WINDOW  WINDOW_A 
AIM>  DEL  WINDOW  WINDOW  B 


BOTTOM-OF-SCREEN 


Comments:  WIND0W_A  has  been  deleted  from  the  AIM's  internal 

v i ndows . 

Command:  DEL  WINDOW  WINDOW_B  -  Remove  WINDOW_B  from  the  internal 

windows  in  the  AIM  environment. 


list 

of 

list 

of 
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DELETE  WINDOW  WINDOW_C 

AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT_TY?E  =>  WINDOW  W I NDOW_NAME  =>  WINDOW_A 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDCW_C 
AIM>  ASSOC  WINDOW_A  IMAGE_1  1  8 
AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 
AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  GOTO  WINDOW  WINDOW  C 
AIM>  DIS  WINDCW_A  IMAGE_1 
AIM>  DIS  WINDOW_B  IMAGE_i 
AIM>  DIS  W I NDOW_C  IMAGE_1 
AIM>  DEL  WINDOW  WINDOW_A 
AIM>  DEL  WINDOW  WINDOW_B 
AIM>  DEL  WINDOW  WINDOW  C 


BOTTOM-CF-SCREEN 


Comments:  WIND0W_B  has  been  deleted  from  the  AIM's  internal  list 

windows . 

Command:  DEL  WINDOW  WINDOW_C  -  Remove  WINDOW_C  from  the  internal  list 

windows  in  the  AIM  environment. 
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DELETE  IMAGE  I MAGE_1 

AIM  ATM  ATM  CL  I  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WI NDOW_NAME  =>  WINDOW_A 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDOW_C 
AIM>' ASSOC  WINDCW_A  IMAGE_1  1  8 
AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 
AIM>  ASSOC  WINDCW_C  IMAGE_i  17  8 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  GOTO  WINDOW  WINDOW_C 
A IM>  DIS  W I NDOW_ A  IMAGE_1 
AIM>  DIS  WIND0W_3  IMAGE_1 
AIM>  DIS  WINDOW_C  IMAGE_1 
A I M>  DEL  WINDOW  WINDOW_A 
AIM>  DEL  WINDOW  WINDOW_B 

a:m>  del  window  window_c 

AIM>  DEL  IMAGE  IMAGE  1 


BOTTOM-OF- SCREEN 


Comments : 
windows . 

WINDCW_C  has  been  deleted 

f  rom 

the 

AIM's 

internal 

list 

of 

Command : 

DEL  IMAGE  IMAGE  1  -  Remove 

IMAGE  1 

f  rom 

the 

interna  1 

list 

of 

images  in  the  AIM  environment. 
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EXIT  AIM 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IMAGE_1 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WINDCW_A 
AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDOW_C 
AIM>  ASSOC  WINDOW_A  I MAGE_1  1  8 
AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 
AIM>  ASSOC  WINDOW_C  IMAGE_1  17  8 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  GOTO  WINDOW  WINDOW_C 
AIM>  DIS  W I NDOW_A  IMAGE_1 
AIM>  DIS  W I NDOW_B  IMAGE_1 
AIM>  DIS  WINDOW_C  IMAGE_1 
AIM>  DEL  WINDOW  WINDOW_A 
AIM>  DEL  WINDOW  WINDOW_B 
AIM>  DEL  WINDOW  WINDOW_C 
AIM>  DEL  IMAGE  IMAGE_1 
AIM>  EXIT 


_ BOTTOM -OF- SCREEN _ 

Comments:  IMAGE_1  has  been  deleted  from  the  AIM's  internal  list  of  images. 

Command:  EXIT  -  Exit  the  AIM  session. 
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AIM  SUCCESSFULLY  EXITED 

AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  OBJECT_TYPE=> IMAGE  IMAGE_NAME=> IMAGE_1 
AIM>  CREATE  OBJECT_TYPE=>WINDOW  WINDOW_NAME=>WINDOW_A 
AIM>  CREATE  OBJECT_TYPE=>WINDOW  WINDOW_B 
AIM>  CR  WINDOW  WINDOW_C 
AIM>  ASSOC  W I NDOW_A  I MAGE_ 1  1  8 
AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 
AIM>  ASSOC  WINDOW  C  IMAGE_1  l7  8 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  GOTO  WINDOW  WINDOW_C 
AIM>  DIS  WINDOW_A  IMAGE_1 
AIM>  DIS  WINDOW_B  IMAGE_1 
AIM>  DIS  WINDOW_C  IMAGE_I 
A I M>  DEL  WINDOW  WINDOW_A 
AIM>  DEL  WINDOW  WINDOW_B 
AIM>  DEL  WINDOW  WINDOW_C 
AIM>  DEL  IMAGE  IMAGE_1 
AIM>  EXIT 
-) 


I 

1  BOTTOM-OF-SCREEN 


Comments:  The  AIM  has  terminated  its  execution  and  the  prompt  from  the 

underlying  APSE  reappears. 

Command:  None. 
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A. 2  SESSION  2  -  SCRIPT  AND  DEFINE  COMMANDS 


The  following  session  demonstrates  the  use  of  the  DEFINE  TERMINAL, 
DEFINE  BINDING,  and  SCRIPT  commands.  The  DEFINE  BINDING  binds  a 
keystroke(s)  to  a  key  sequence  and  DEFINE  TERMINAL  indicates  to  the 
AIM  the  type  of  terminal  being  used.  The  DEFINE' s  are  shown  first 
followed  by  the  SCRIPT  command.  The  actual  keystrokes  are 
demonstrated  in  the  next  session.  The  following  script  files  are  used 
ir.  this  session: 


demol . aim 

CREATE  IMAGE  IMAGE_1 
CREATE  IMAGE  IMAGE_2 
CREATE  WINDOW  WINDOW_A 
CREATE  WINDOW  WINDOW_3 
CREATE  WINDOW  WINDOW_C 
CREATE  WINDOW  WINDOW_D 
ASSOC  WINDCW_A  IMAGE_1  1  8 

ASSOC  WINDOW_B  IMAGE_1  9  8 

ASCOC  WINDOW _C  IMAGE_1  17  8 

ASSOC  W I NDOW_C  IMAGE_2  1  12 

ASSOC  WINDOW  D  IMAGE  2  13  12 
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SESSION  2 
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INVOKE  AIM  FROM  APSE 

-)  AIM 


_ BOTTOM_OF_SCREEN _ 

Comments : 

Command:  AIM  -  invoke  the  AIM  from  the  APSE. 
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MAIN 

AOS/VS  CL I 


SWITCH  TO  AIM  IMAGE 
MAUN  FRCH: 016  Running 

REV  05.01.00.00  9-APR-85  13:26:43 


{ F10  } 


AF 


BOTTOM  OF  SCREEN 


Comments:  The  AIM  initializes  the  current  image  to  be  MAIN.  To  enter  AIM 
textual  commands,  the  user  must  communicate  through  the  AIM  window  to  the 
AIM  command  interpreter. 

Command:  { F 1 0 }  -  Set  the  current  image  to  be  the  AIM  image.  This  is  the 
default  binding  for  the  SWITCH_TO_AIM  keystroke. 
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DEFINE  TERMINAL 


AIM  AIM  AIM  CLI 

AIM>  DEFINE  TERMINAL  "TV970" 


Runn  1  r.g 


AF 


BOTTOM  OF  SCREEN 


Comments:  The  cursor  is  now  at  the  top  of  the  AIM  image.  AIM  commands  can 
only  be  entered  in  the  AIM  image.  Control  has  been  passed  to  the  AIM  Cl 
executing  in  the  AIM  window. 

Command:  DEFINE  TERMINAL  "TV970"  -  Define  the  terminal  to  be  a  Televideo 
TV970. 
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DEFINE  KEYSTROKES  -  CLEAR  WINDOW 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  DEFINE  TERMINAL  "TV970" 

AIM>  DEFINE  BINDING  CLEAR  WINDOW  F2 


BOTTOM  OF  SCREEN 


Comments:  The  terminal  was  defined  as  a  TV970.  Next  each  keystroke  will 

be  defined. 

Command:  DEFINE  BINDING  CLEAR_WINDOW  F2  This  defines  the  CLEAR_WINOCW 

keystroke  to  be  the  function  key  shown. 
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DEFINE  KEYSTROKES  -  NEXT  IMAGE 


AIM 

AIM>  DEFINE 
AIM>  DEFINE 
AIM>  DEFINE 


AIM  AIM  CLI 

TERMINAL  "TV970" 
BINDING  CLEAR_W I NDOW 
BINDING  NEXT  IMAGE  F3 


F2 


Runn ing 


AF 


BOTTOM  OF  SCREEN 


Comments:  The  first  one  is  the  CLEAR_WIND0W  keystroke.  This  keystroke, 
when  used,  will  clear  the  current  window  except  for  the  header  information. 

Command:  DEFINE  BINDING  NEXT_IMAGE  F3  This  defines  the  NEXT_IMAGE 

keystroke  to  be  the  function  key  shown. 
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DEFINE  KEYSTROKES  -  NEXT  VIEWPORT 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  DEFINE  TERMINAL  "TV970" 

AIM>  DEFINE  BINDING  CLEAR_WINDOW  F2 
AIM>  DEFINE  BINDING  NEXT_IMAGE  F3 
AIM>  DEFINE  BINDING  NEXT  VIEWPORT  F5 


BOTTOM  OF  SCREEN 


Comments:  The  NEXT  IMAGE  keystroke,  when  used,  causes  the  cursor  to  move 
to  the  image  following  the  current  image.  The  move  is  base'd  on  the 
alphabetical  ordering  of  the  images. 


Command:  DEFINE  BINDING  NEXT_V I EWPORT  F5  This  defines  the  NEXT_VIEWPCR7 

keystroke  to  be  the  function  key  shown. 
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DEFINE  KEYSTROKES  -  PREVIOUS  IMAGE 


AIM 

AIM 

AIM  CLI 

Running 

AIM> 

DEFINE 

TERMINAL  "TV970" 

AIM> 

DEFINE 

BINDING 

CLEAR  WINDOW 

F2 

AIM> 

DEFINE 

BINDING 

NEXT  IMAGE  F3 

AIM> 

DEFINE 

BINDING 

NEXT  VIEWPORT 

F5 

AIM> 

DEFINE 

BINDING 

PREVIOUS  IMAGE 

F6 

BOTTOM  OF  SCREEN 


Comments:  The  NEXT_VIEWPORT  keystroke  causes  the  cursor  to  move  to  the 
next  viewport  of  the  current  image.  The  move  is  down  the  screen  to  the 
next  viewport  unless  the  cursor  is  in  the  last  viewport  of  the  screen.  In 
this  case,  the  cursor  moves  to  the  viewport  at  the  top  of  the  screen. 

Command:  DEFINE  BINDING  PREVIOUS_IMAGE  F6  This  defines  the  PREVIOUS_IMAGE 
keystroke  to  be  the  function  key  shown. 
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DEFINE  KEYSTROKES  -  PREVIOUS  VIEWPORT 


AIM 

AIM>  DEFINE 
AIM>  DEFINE 
AIM>  DEFINE 
AIM>  DEFINE 
AIM>  DEFINE 
AIM>  DEFINE 


AIM  AIM  CLI  Running 

TERMINAL  "TV970" 

BINDING  CLEAR_W I NDOW  F2 
BINDING  NEXT_IMAGE  F3 
BINDING  NEXT_V I EWPORT  F5 
BINDING  PREV I OUS_ I MAGE  F6 
BINDING  PREVIOUS  VIEWPORT  F7 


AF 


BOTTOM  OF  SCREEN 


Comments:  The  PREVIOUS_IMAGE  keystroke  is  the  complement  to  the  NEXT_IMAGZ 
keystroke.  The  cursor  will  move  to  the  previous  image  based  on  the 
alphabetical  ordering  of  the  images. 

Command:  DEFINE  BINDING  PREVIOUS_VIEWPORT  F7  This  defines  the 
PREVICUS_VIEWPORT  keystroke  to  be  the  function  key  shown. 


A-  34 


PAGE  TERMINAL  TUTOR! 
SESSION  2  -  SCRIPT  AND  DEFINE  COMMAN 


DEFINE  KEYSTROKES  -  REDISPLAY  SCREEN 


AIM 

AIM 

AIM> 

DEFINE 

TERMINAL 

AIM> 

DEFINE 

BINDING 

A I  M> 

DEFINE 

BINDING 

A  IM> 

DEFINE 

BINDING 

A  IM> 

DEFINE 

BINDING 

AIM> 

DEFINE 

B I ND I NG 

A  IM> 

DEFINE 

3INDING 

AIM  CLI 
"TV970" 

CLEAR_WINDOW  F2 
NEXT_IMAGE  F3 
NEXT_V I EWPORT  F5 
PREV I OUS_ I MAGE  F6 
PRE V I OUS_ V I EWPORT 
REDISPLAY  SCREEN  F8 


Runn  i  ng 


F7 


AF 


BOTTOM  OF  SCREEN 


Comments:  The  PREVlOrJS_VlEWPORT  keystroke  is  the  complement  of  the 
NEXT_V I EWPORT  keystroke.  It  moves  the  cursor  to  the  viewport  above  the 
current  viewport  on  the  screen.  If  there  is  no  viewport  above  the  current 
viewport  then  the  cursor  moves  to  the  last  viewport  on  the  screen. 

Command:  DEFINE  BINDING  REDI SPLAY_SCREEN  F8  This  defines  the 
REDISPLAY_SCRSSN  keystroke  to  be  the  function  key  shown. 
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DEFINE  KEYSTROKES  -  RETURN  TO  PREVIOUS  IMAGE 


AIM 

AIM 

AIM> 

DEFINE 

TERMINAL 

AIM> 

DEFINE 

BINDING 

A  IM> 

DEFINE 

BINDING 

AIM> 

DEFINE 

B I ND I NG 

A  IM> 

DEFINE 

BINDING 

A  IM> 

DEFISE 

BINDING 

A  IM> 

DEFINE 

BINDING 

AIM> 

DEFINE 

BINDING 

AIM  CLI 
"TV970  " 

CLEAR_W I NDOW  F2 
NEXT_IMAGE  F3 
NEXT_V I EWPORT  F5 
PREVIOUS_IMAGE  Ffc 
PRE V I OUS_V I EWPORT 
RED  I S P LA Y_S C RE EN 
RETURN  TO  PREVIOUS 


Ru.nn  i  ng 


F7 

8 

IMAGE  F9 


AF 


BOTTOM  OF  SCREEN 


Comments:  The  REDISPLAY_SCREEN  keystroke  repaints  the  entire  screen, 

information  that  has  been  written  on  the  screen  by  the  operating  sys 
will  not  be  RED  I SPLAYed . 

Command:  DEFINE  BINDING  RETURN_TC_?REVIOUS_IMAGE  F9  This  defines 

RETURN_TO_?REVIOUS_IMAGE  keystroke  to  be  the  function  key  shown. 
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DEFINE  KEYSTROKES  -  SWITCH  TO  AIM 


AIM 

AIM 

A  I  M> 

DEFINE 

TERMINAL 

AIM> 

DEFINE 

BINDING 

A  IM> 

DEFINE 

3INDING 

AIM> 

DEFINE 

BINDING 

A  IM> 

DEFINE 

BINDING 

AIM> 

DEFINE 

BINDING 

MM> 

DEFINE 

BINDING 

A I  M> 

DEFINE 

B I ND I NG 

A  IM> 

DEFINE 

BINDING 

AIM  CLI 


Runm  ng 


AF 


F2 


IMAGE  F3 


F5 

F6 


F7 

F8 


F9 


BOTTOM  OF  SCREEN 


Comments:  The  RETURN_TO_PREVlOUS_IMAGE  keystroke  is  different  from  the 
PR£VIOUS_IMAGE  keystroke  in  that  the  cursor  movement  associated  with  this 
keystroke  is  not  based  on  the  alphabetical  ordering  of  the  images.  This 
keystroke  moves  the  cursor  to  the  image  that  the  cursor  was  in  prior  to  the 
current  image. 

Command:  DEFINE  BINDING  SWITCH_TO_AIM  F10  This  defines  the  SWITCH_T0_AIM 
keystroke  to  be  the  function  key  shown. 
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DEFINE  KEYSTROKES  -  ABORT  SCRIPT 


AIM 

AIM 

AIM> 

DEFINE 

TERMINAL 

AIM> 

DEFINE 

BINDING 

AIM> 

DEFINE 

BINDING 

AIM> 

DEFINE 

BINDING 

AIM> 

DEFINE 

BINDING 

AIM> 

DEFINE 

BINDING 

AIM> 

DEFINE 

BINDING 

AIM> 

DEFINE 

BINDING 

AIM> 

DEFINE 

BINDING 

A  IM> 

DEFINE 

BINDING 

AIM  CLI  Running 

"TV970" 

CLEAR_W I NDOW  F2 
NEXT_IMAGE  F3 
NEXT_V I EWPORT  F5 
PREV I OUS_ I MAGE  F6 
PREV I OUS_V I EWPORT  F7 
RED I SPLAY_SCREEN  F8 
RETURN_TO_PREV I OUS_ I MAGE 
SW I TCH_TO_A I M  FiO 
ABORT  SCRIPT  FI 


F9 


AF 


BOTTOM  OF  SCREEN 


Comments:  The  SWITCH_T0_AIM  keystroke  returns  the  cursor  to  the  AIM  image. 
This  keystroke  is  used  to  restart  scripts  that  have  stopped  because  of 
embedded  INFO  or  HELP  commands.  Also,  if  a  script  contains  a  GOTO  command, 
when  this  keystroke  is  entered  the  cursor  will  return  to  the  AIM  window  and 
the  script  will  then  resume. 

Command:  DEFINE  BINDING  ABORT_SCRIPT  Fl  This  defines  the  AEORT_SCRIPT 
keystroke  to  be  the  function  key  shown. 
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DEFINE  KEYSTROKES  -  NEXT  PAGE 


AIM  AIM  AIM  CLI  Running  AF 

i  AIM>  DEFINE  TERMINAL  "TV970" 

j  AIM>  DEFINE  BINDING  CLEAR_WINDOW  F2 

AIM>  DEFINE  BINDING  NEXT_IMAGE  F3 

AIM>  DEFINE  BINDING  NEXT_VIEWPORT  F5 

AIM>  DEFINE  BINDING  PREVIOUS_IMAGE  F6 

AIM>  DEFINE  BINDING  PREVIOUS_VIEWPORT  F7 
AIM>  DEFINE  BINDING  RED I SPLAY_SCREEN  F8 
i  AIM>  DEFINE  BINDING  RETURN_TO_PREVIOUS_IMAGE  F9 
AIM>  DEFINE  BINDING  SWITCH_TO_AIM  F10 

1  AIM>  DEFINE  BINDING  ABORT_SCRIPT  FI 

AIM>  DEFINE  BINDING  NEXT  PAGE  F4 


BOTTOM  OF  SCREEN 


Comments:  The  ABORT_SCRIPT  keystroke  aborts  all  scripts.  This  includes 

all  levels  of  nested  scripts. 

Command:  DEFINE  BINDING  NEXT_PAGE  F4  This  defines  the  NEXT  PAGE  keystroke 

to  be  the  function  key  shown. 


PAGE  TERMINAL  TUTORIAL 

SESSION  2  -  SCRIPT  AND  DEFINE  COMMANDS 


EXECUTE  THE  SCRIPT  COMMAND 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  DEFINE  TERMINAL  "TV970" 

AIM>  DEFINE  BINDING  CLEAR_WINDOW  F2 

AIM>  DEFINE  BINDING  NEXT_ IMAGE  F3 

AIM>  DEFINE  BINDING  NEXT_VIEWPORT  F5 

AIM>  DEFINE  BINDING  PREV IOUS_IMAGE  F6 

AIM>  DEFINE  BINDING  PREV I OUS_ VIEWPORT  F7 

AIM>  DEFINE  BINDING  RED I SPLAY_SCREEN  F8 

AIM>  DEFINE  BINDING  RETURN_TO_PREVIOUS_IMAGE  F9 

AIM>  DEFINE  BINDING  SWITCH_TO_AIM  F10 

AIM>  DEFINE  BINDING  ABORT_SCRIPT  FI 

AIM>  DEFINE  BINDING  NEXT_PAGE  F4 

AIM>  SCRIPT  "demol.aim" 


BOTTOM  OF  SCREEN 


Comments:  The  NEXT^PAGE  keystroke  is  used  in  conjunction  with  the  SET  FULL 

command  (see  session  4).  When  the  SET  FULL  flag  is  on,  a  flag  is  set  ir. 
the  header  indicating  that  there  is  more  information  than  will  fit  in  th 
window.  If  the  next  page  of  information  is  to  be  seen,  the  NEXT_PAG 
keystroke  is  used. 

Command:  SCRIPT  "demol.aim"  -  Invoke  a  script  called  demol.  (demol  is  a 

system  dependent  name.) 
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ECHO  THE  SCRIPT  COMMANDS 

AIM  ATM  AIM  CLI  Running 

AIM>  DEFINE  BINDING  CLEAR_WINDOW  F2 
AIM>  DEFINE  BINDING  NEXT_IMAGE  F3 
AIM>  DEFINE  BINDING  NEXT_VI EWPORT  F5 
AIM>  DEFINE  BINDING  PREVIOUS_IMAGE  F6 
AIM>  DEFINE  BINDING  PREVIOUS_VIEWPORT  F7 
AIM>  DEFINE  BINDING  RED I SPLAY_SCREEN  F8 
AIM>  DEFINE  BINDING  RETURN_TO_PREVIOUS_IMAGE  F9 
AIM>  DEFINE  BINDING  SWI TCH_TO_AIM  F10 
AIM>  DEFINE  BINDING  ABORT_SCRIPT  FI 
AIM>  DEFINE  3INDING  NEXT_PAGE  F2 
AIM>  SCRIPT  "demol .aim" 

AIM>  CREATE  IMAGE  IMAGE_1 

AIM>  CREATE  IMAGE  IMAGE_2 

AIM>  CREATE  WINDOW  WINDOW_A 

AIM>  CREATE  WINDOW  WINDOW_B 

AIM>  CREATE  WINDOW  WINDOW_C 

AIM>  CREATE  WINDOW  WINDOW_D 

AIM>  ASSOC  W I NDOW_A  IMAGE_1  1  8 

AIM>  ASSOC  W I NDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  WINDOWJZ  IMAGE_1  17  8 

AIM>  ASSOC  W I NDOW_C  IMAGE_2  1  12 

AIM>  ASSOC  WINDOW_D  IMAGE_2  13  12 

AIM>  EXIT 

BOTTOM  OF  SCREEN 


Comments:  The  SCRIPT  command  invokes  a  previously  created  command  script. 
The  script  contains  AIM  commands  and  comments  only.  The  script  can  be 
created  using  a  system  supplied  editor.  Nesting  of  script  is  allowed.  See 
Session  3  for  an  example  of  nested  scripts.  The  SCRIPT  is  echoed  to  the 
screen  as  each  command  is  read  and  executed  by  the  AIM.  This  completes  the 
session  on  the  DEFINES  and  SCRIPT.  Exit  the  AIM. 

Command:  EXIT  -  Exit  this  session. 
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ECHO  THE  SCRIPT  COMMANDS 

AIM  AIM  AIM  CLI  Running  A 

AIM>  DEFINE  BINDING  NEXT_IMAGE  F3 
AIM>  DEFINE  BINDING  NEXT_V I EWPORT  F5 
AIM>  DEFINE  BINDING  PREVIOUS_IMAGE  F6 
AIM>  DEFINE  BINDING  PREVIOUS_VI EWPORT  F7 
AIM>  DEFINE  BINDING  RED  I SPLAY_SCREEN  F8 
AIM>  DEFINE  BINDING  RETURN_TO_PREV IOUS_IMAGE  F9 
AIM>  DEFINE  BINDING  SWITCH_TO_AIM  F10 
AIM>  DEFINE  BINDING  ABORT_SCRIPT  Fl 
AIM>  DEFINE  BINDING  NEXT  PAGE  F4 


AIM> 

SCRIPT 

"demol .aim" 

AIM> 

CREATE 

IMAGE 

IMAGE  1 

AIM> 

CREATE 

IMAGE 

IMAGE  2 

AIM> 

CREATE 

WINDOW 

WINDOW 

A 

AIM> 

CREATE 

WINDOW 

WINDOW 

B 

AIM> 

CREATE 

WINDOW 

WINDOW 

C 

AIM> 

CREATE 

WINDOW 

WINDOW 

D 

AIM> 

ASSOC 

WINDOW  A 

IMAGE 

1 

1 

8 

AIM> 

ASSOC 

WINDOW  B 

IMAGE 

1 

9 

8 

AIM> 

ASSOC 

WINDOW  C 

IMAGE 

1 

17 

8 

AIM> 

ASSOC 

WINDOW  C 

IMAGE" 

2 

1 

12 

AIM> 

ASSOC 

WINDOW  D 

IMAGE 

2 

13 

12 

AIM> 

EXIT 

-) 

BOTTOM  OF  SCREEN 


Comments:  AIM  exited. 

Command:  None. 
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A. 3  SESSION  3  -  KEYSTROKE  COMMANDS 

The  following  session  demonstrates  the  use  of  the  KEYSTROKE  commands. 

The  session  is  started  by  executing  a  script  that  defines  the 
keystrokes  and  terminal  type  (see  Session  2).  The  following  text 
files  are  used  in  this  session: 

1.  demol.aim 


CREATE 

IMAGE 

I  MACE  1 

CREATE 

IMAGE 

IMAGE  2 

CREATE 

WINDOW 

WINDOW 

A 

CREATE 

WINDOW 

W I NDOW 

B 

CREATE 

WINDOW 

WINDOW 

C 

CREATE 

W I NDOW 

WINDOW 

D 

ASSOC 

WINDOW  A 

IMAGE 

1 

1 

8 

ASSOC 

WINDOW  B 

IMAGE 

i 

9 

8 

ASSOC 

WINDOW  C 

IMAGE 

1 

17 

8 

ASSOC 

WINDOW  C 

IMAGE 

2 

1 

12 

ASSOC 

WINDOW  D 

IMAGE 

2 

13 

12 

2.  demo!3.aim 

SCRIPT  "demol.aim'’ 

SCRIPT  "demol4 . a im" 

3.  demo 14. aim 

DEFINE  BINDING  CLEAR_WINDOW  F2 

DEFINE  BINDING  NEXT_IMAGE  F3 

DEFINE  BINDING  NEXT_V I EWPORT  F5 

DEFINE  BINDING  *  PHEVIOUSIMAGE  F6 

DEFINE  BINDING  PREVIOUS_VIEWPORT  F7 

DEFINE  BINDING  RED r SPLAY-SCREEN  F8 

DEFINE  3INDING  RETURN_TO_PREVIOUS_IMAGE  F9 

DEFINE  BINDING  SW I TCH_TO_A I M  F10 

DEFINE  BINDING  ABORT_SCRIPT  FI 

DEFINE  BINDING  NEXT_PAGE  F4 

INFO  KEYS  * 

GOTO  IMAGE  IMAGE_1 

4.  demol2.aim 

<This  script  contains  comments  only> 
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INVOKE  AIM  FROM  APSE 


-)  AIM 


BOTTOM-OF-SCREEN 


Comments: 

Command:  AIM  -  invoke  the  AIM  from  the  APSE. 
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MAIN  MAIN 

AOS/VS  CLI  REV  05.01.00.00 


SWITCH  TO  AIM  IMAGE 
FRCH: 016  Running 

9-APR-85  13:26:43  { F10 } 


AF 


BOTTOM- OF - SCREEN 


Comments:  The  AIM  initializes  the  current  image  to  be  MAIN.  To  enter  AIM 
textual  commands,  the  user  must  communicate  through  the  AIM  image  to  the 
AIM  command  interpreter. 


Command:  { F10 }  -  Set  the  current  image  to  be  the  AIM  image, 

keystroke  is  the  default  for  Switch_to_AIM. 


This 
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INVOKE  SCRIPT 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  SCRIPT  "demol3 .aim" 


BOTTOM-OF-SCREEN 


Comments:  The  cursor  is  now  at  the  top  of  the  AIM  image.  AIM  commands  car. 
only  be  entered  in  the  AIM  image.  Control  has  been  passed  to  the  AIM  Cl 
executing  in  the  AIM  window. 

Command:  SCRIPT  "demol3 .  aim"  -  Invoke  a  script  called  aemol3.air. 
(demol3.aim  is  a  system  dependent  name.) 
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ECHO  SCRIPT  LINES 


AIM 

AIM 

AIM 

CLI 

A  IM> 

SCRIPT 

"demol . 

aim" 

A  IM> 

CREATE 

IMAGE 

IMAGE  1 

AIM> 

CREATE 

IMAGE 

IMAGE  2 

A I  M> 

CREATE 

WINDOW 

WINDOW  A 

A  IM> 

CREATE 

WINDOW 

WINDOW  B 

AIM> 

CREATE 

WINDOW 

WINDOW  C 

A  IM> 

CREATE 

WINDOW 

WINDOW  D 

a:m> 

ASSOC 

WINDOW 

A  IMAGE  1 

1 

8 

A  IM> 

ASSOC 

W I NDOW 

B  IMAGE  1 

9 

8 

A  IM> 

ASSOC 

WINDOW  i 

C  IMAGE  1 

17 

8 

A  IM> 

ASSOC 

WINDOW  < 

C  IMAGE  2 

1 

12 

A  I  M> 

ASSOC 

WINDOW_ 

D  IMAGE_2 

13 

12 

A  IM> 

SCRIPT 

"demo 14 

.aim" 

A  IM> 

DEFINE 

BINDING 

CLEAR  WINDOW 

F2 

A I  M> 

DEFINE 

BINDING 

NEXT  IMAGE  F3 

a:m> 

DEFINE 

BINDING 

NEXT  VIEWPORT 

F5 

a:m> 

DEFINE 

3INDING 

PREVIOUS 

IMAGE 

F6 

a:m> 

DEFINE 

B I ND I NG 

PREVIOUS  ' 

VIEWPORT 

A  IM> 

DEFINE 

BINDING 

REDISPLAY 

SCREEN 

A  IM> 

DEFINE 

BINDING 

RETURN  TO 

PREVIOUS 

AIM> 

DEFINE 

BINDING 

SWITCH  TO 

AIM 

F10 

A  IM> 

DEFINE 

BINDING 

ABORT  SCRIPT 

FI 

A  IM> 

DEFINE 

3 I ND I NG 

NEXT  PAGE 

F4 

{ F4 } 

Runn i ng 


More . 


AF 


F  7 
F8 

IMAGE 


F9 


BOTTOM-OF-SCREEN 


Comments:  Invoke  a  script.  Script  demo3  actually  invokes  script  demol  and 
then  script  demo4 .  The  first  script  sets  up  an  environment  in  which  to 
test  the  keystrokes.  The  second  script  will  define  the  keystrokes  with  the 
same  key  sequences  as  in  Session  2.  Note  that  the  screen  has  scrolled. 
The  initial  command  to  invoke  a  script  and  the  first  command  of  that  script 
(SCRIPT  demol. aim)  have  scrolled  off  the  screen. 

{ F  4 } 


Command : 
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INFO  ON  KEYSTROKES 


AIM  AIM 
AIM>  DEFINE  BINDING 
AIM>  DEFINE  BINDING 
AIM>  DEFINE  BINDING 
AIM>  DEFINE  BINDING 
AIM>  DEFINE  BINDING 
AIM>  DEFINE  BINDING 
AIM>  DEFINE  BINDING 
AIM>  INFO  KEYS  * 


AIM  CL  I  Running 

PREVIOUS_IMAGE  Fb 
PREV I OUS_ VIEWPORT  F7 
REDI SPLAY_SCREEN  F8 
RETURN_TO_PREV I OUS_ I  MAGE  F9 
SWITCH_TO_AIM  FIG 
ABCRT_SCR I PT  Pi 
NEXT  PAGE  F 4 


AF 


Keystroke  Command  Name 


Key  Sequence 


ABORT_SCRI PT  FI 

CLEAR_WINDOW  F2 

NEXT_IMAGE  F3 

NEXT_PAGE  F  4 

NEXT_ VIEWPORT  F5 

PREV IOUS_ IMAGE  F6 

PREV I OUS_V I EWPORT  F7 

REDI SPLAY_SCREEN  F8 

RETURN_TO_PR£V I OUS_ I MAGE  F9 

SWITCH  TO  AIM  F10 


INFO  Object? 


{ return } 


BCTTCM-CF -SCREEN 


Comments:  At  this  point,  the  INFO  command  is  used  to  see  that  the 
assignments  made  for  the  keystrokes  exist.  The  information  on  all  the  Aim 
keystrokes  is  displayed.  Note  that  script  I/O  has  been  switched  t; 
interactive  while  in  the  INFO  utility. 

Command:  {return}  -  Exit  the  current  level  of  the  INFO  utility  with  a 
carriage  return. 
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RESUME  SCRIPT 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  DEFINE  BINDING  RED I SPLAY_SCREEN  F8 
AIM>  DEFINE  BINDING  RETURN_TC_PREVIOUS_IMAGE  F9 
AIM>  DEFINE  BINDING  SWI TCH_TO_AIM  F10 
AIM>  DEFINE  BINDING  ABORT_SCRIPT  FI 
AIM>  DEFINE  BINDING  NEXT_PAGE  F4 
AIM>  INFO  KEYS  * 


Keystroke  Command  Name 


Key  Sequence 


A3CRT_SCRIPT  FI 

CLEAR_W I NDOW  F2 

NEXT_IMAGE  F3 

NEXT_PAGE  F4 

NEXT_V I EWPORT  F5 

?REVIOUS_IMAGE  F6 

P  REV I OUS_V I EWPORT  F7 

RED I SPLAY_SCREEN  F8 

RETURN_TO_?RE V I OUS_ I MAGE  F9 

SWITCH  TO  AIM  F10 


INFO  Object? 

AIM>  GOTO  IMAGE  IMAGE_1 

_  BOTTOM-OF-SCREEN 


Comments:  The  INFO  utility  has  been  exited.  The 

point . 

script 

resumes 

at 

this 

Command:  GOTO  IMAGE  IMAGE  1  -  This  command  is  in 

command  puts  the  cursor  to  the  specified  image. 

the 

script . 

The 

GOTO 
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SWITCH  TO  NEXT  VIEWPORT 


IMAGE_1 

AOS /VS  CL  I 

WINDOW_A 

REV  05.01.00.00 

FRCH: 017 

11 -APR-85 

Runn i ng 

8  :  c5  :  29  { F5 } 

A  F 

' MAGE_ 1 

acs/vs  cl: 

WINDOW_B 

REV  05.01.00.00 

FRCH: 018 

ll-APR-85 

Running 

8:55:29 

A  F 

IMAG2_i 

AOS /VS  cl: 

WINDOW  C 

REV  05.01.00.00 

FRCH: 019 

ll-APR-85 

Running 

8:55:29 

AF 

BOTTOM-OF-SCREEN 


Comments:  The  next  script  command  is  a  GOTO.  Go  to  IMAGE_1.  IMAGE_1  va 
previously  created  in  the  first  script,  demol.  A  demonstration  of  most  o 
the  keystrokes  will  be  done  once  out  of  the  AIM  image. 

Command:  { F 5 }  -  NEXT_VIEWPORT  keystroke  is  entered. 
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SW T  TCH 

'T'f  ~  V  C 
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v;r>-- X 

TUTORIAL 

COMMANDS 

I MAGE_1 

AOS/VS  CL I 

WINDOW_A 

REV  05.01  .u0.  :  > 

j :  r,  l :  29 

AF 

IMAGE_1 

W I NDOW_3 

FRCH: 018 

Running 

AF 

AOS /VS  CL  I 

REV  05.01.00.00 

ll-APR-85 

8:55:29  { F7 } 

:mage_i 

W I NDOW_C 

FRCH: 019 

Runn i ng 

AF 

aos/vs  cl: 

REV  05.01.00.00 

ll-APR-85 

8:55:29 

BOTTOM-OF-SCREEN 


Comments : 
viewport 

The  first  keystroke  is 
IMAGE_i ,  W I NDOW_B . 

NEXT_V I EWPORT . 

The 

cursor  will 

move 

to 

Command: 
IMAGE_1 , 

{ F7 }  -  PREVIOUS  VIEWPORT 
WINDOW_A. 

keystroke . 

Move 

the  cursor 

back 

to 
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REDISPLAY  SCREEN 


IMAGE_1 

WINDOW_A 

FRCH:017  Running 

A  F 

AOS /VS  CL I 

REV  05.01.00 

.00 

ll-APR-85  8:55:29 

)  ***  [OPER] 

System  going 

down 

in  five  minutes  ***  { F8 } 

IMAGE_ 

_1 

WINDOW_B 

FRCH:018  Running 

AF 

AOS /VS 

CL  I 

REV  05.01.00.00 

ll-APR-85  8:55:29 

IMAGE_I 

WINDOW_C 

FRCH : 01 9 

Running 

AF 

AOS/VS  CLI 

REV  05.01.00.00 

11- APR- R 5 

3:55:29 

BOTTOM-OF-SCREEN 


Comments:  Now  the  cursor  has  moved  back  to  viewport  IMAGE_1,  WINDCW_A. 

Command:  { F8 }  -  REDISPLAY_SCREEN  keystroke.  This  keystroke  repaints 

screen . 
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SWITCH 

TO  NEXT  ALPHA 

IMAGE 

IMAGE_1 

AOS/VS  CL I 

WINDOW_A 

REV  05.01.00.00 

FRCH: 017 

1 1- APR-8  5 

Running 

8:55:29  { F3  j 

AF 

:mage_i 

AOS/VS  CL I 

WINDOW_B 

REV  05.01.00.00 

FRCH: 018 

1 1 -APR-8  5 

Running 

8:55:29 

AF 

:mage_i 

ACS/VS  CL I 

WINDOW_C 

REV  05.01.00.00 

FRCH: C 19 

ll-APR-85 

Running 

8:55:29 

AF 

BOTTOM-OF-SCREEN 


Comments:  If  the  screen  is  written  on  by  the  system  it  can  be  redisplayed 

with  the  RED I SPLAY_SCREEN  keystroke. 

Command:  { F 3 }  -  NEXT_IMAGE  keystroke.  Move  the  cursor  to  the  next  imaqe. 
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SWITCH  TO  AIM 

IMAGE_2  W I NDOW_C  FRCH : 0 19  Running  AF 

AOS/VS  CLI  REV  05.01.00.00  il-APR-85  8:55:29  {F10} 


IMAGE_2  WINDOWED  FRCH: 020  Running 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29 


AF 


BOTTOM-OF-SCREEN 


Comments:  To  demonstrate  the  CLEAR_WINDOW  keystroke  first  enter  some  tex 

in  the  window.  After  entering  the  text  clear  the  window. 

Command:  fF10}  -  Enter  the  SWITCH_TO_AIM  keystroke  to  return  to  the  AI 

window. 
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SWITCH  TO  PREVIOUS  IMAGE 

AIM  AIM  AIM  CLI  Running  AF 

AIM>  DEFINE  BINDING  SWITCH_TO_AIM  F10 
AIM>  DEFINE  BINDING  ABORT_SCRIPT  FI 
AIM>  DEFINE  BINDING  NEXT_PAGE  F4 
AIM>  INFO  KEYS  * 


Keystroke  Command  Name 


Key  Sequence 


A30RT_SCR I PT  Fi 

CLEAR_WINDOW  F2 

NEXT_IMAGE  F3 

NSXT_PAGE  F4 

NEXT_V I EWPORT  F5 

PREVIOUS_IMAGE  F6 

PREV I OUS_V I EWPORT  F7 

REDISPLAY_SCREEN  F8 

RETURN_TO_PRE V I OUS_ I MAGE  F9 

SWITCH  TO  AIM  F10 


INFO  Object? 


AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  { F9 } 

BOTTOM-OF-SCREEN 


Comments : 
image. 

Command: 


The  SWITCH_TO_AIM  keystroke  will  move  the  cursor  back  to  the  AIM 
{ F9 }  -  RETURN_TO_PREV I OUS_ I MAGE  keystroke.  Return  to  IMAGE_2. 
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_______  ______  _______  _________  AFS 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29  {F6} 


IMAGE_2  W I NDOW_D  FRCH:020  Suspended  AFS 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29 


BOTTOM-CF-SCREEN 


Comments:  Note  that  the  script  has  completed  and  that  commands  are  entere 
interactively.  The  RETURN_TO_PREVIOUS_IMAGE  keystroke  returns  the  curse 
to  IMAGE_2 .  Note  that  the  suspended  flags  are  set.  This  resulted  fro 
executing  the  SW I TCH_TO_A I M  keystroke. 

Command:  { F6 }  -  PREVIOUS_IMAGE  keystroke.  This  keystroke  will  put  th 
cursor  back  in  IMAGE_1. 
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IMAGE_1 
AOS/VS  CL I 


WINDOW_A 
REV  05.01.00.00 


SWITCH  TO  AIM 

FRCH : 0 17  Suspended 

ll-APR-85  8:55:29  {F10} 


AFS 


IMAGE_1 
AOS./VS  CL  I 


WINDOw_B 
REV  05.01.00.00 


FRCH: 018  Suspended 

ll-APR-85  8:55:29 


AFS 


IMAGE_1 
AOS/VS  CL I 


W I NDOW_C 
REV  05.01.00.00 


FRCH: 019  Suspended 

ll-APR-85  8:55:29 


AFS 


BOTTOM-OF-SCREEN 


Comments:  Go  back  to  IMAGE_1  by  entering  the  PREVlOUS_IMAGE  keystroke  to 
move  the  cursor  to  the  previous  image  based  on  alphabetical  order.  Enter 
that  keystroke  now. 

Command:  { F 1 0 }  -  SWITCH_TO_AIM  keystroke.  Go  back  to  the  AIM  image. 
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SCRIPT  RESTARTS  -  ABORT  IT 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  DEFINE  BINDING  SWITCH_TO_AIM  F10 
AIM>  DEFINE* BINDING  ABORT_SCRIPT  FI 
AIM>  DEFINE  BINDING  NEXT_PAGE  F4 
AIM>  INFO  KEYS  * 


Keystroke  Command  Name 

ABORT_SCR I PT 

CLE AR_W I NDOW 

NEXT_IMAGE 

NEXT_PAGE 

NEXT_V I EWPORT 

PR£VIOUS_IMAGE 

PREV I OUS_V I EWPORT 

RED I SPLAY_SCREEN 

RETURN_TO_PREV I OUS_ IMAGE 

SW I TCH_TO_ A I M 

INFO  Object?  {return} 

AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  { F2 } 


Key  Sequence 

FI 

F2 

F3 

F4 

F5 

F6 

F7 

F8 

F9 

F10 


BOTTOM-OF-SCREEN 


Comments:  The  cursor  has  now  moved  back  to  the  AIM  image.  The  user  ca 

now  enter  AIM  commands. 

Command:  {F2}  Clear  window 
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AIM  ATM  AIM  CLI  Running  AF 

AIM>  SCRIPT  "demol2 . aim" 


BOTTOM-OF-SCREEN 


Comments:  The  winow  is  cleared 

Command:  SCRIPT  ndemol2 . a imn  -  Execute  another  script. 
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SCRIPT  RESTARTS  -  ABORT  IT 

“AIM  ATM  AIM  CLI  Running  AF 

AIM>  SCRIPT  "demol2 . a im" 

{FI} 


_ BOTTOM-OF -SCREEN _ 

Comments:  The  script  resumes  when  returning  to  the  AIM  image. 

Command:  {FI}  -  Abort  the  script  before  it  gets  started. 
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ENTER  EXIT  COMMAND 


AIM  AIM  AIM  CLI  Running 

AIM>  SCRIPT  "demol2 .aim" 

AIM> 

Aborted  execution  of  script  file:  : USER1 : ATB : AIM: TEST ING : DEM012 . AIM 
AIM>  EXIT 


AF 


BOTTOM-OF-SCREEN 


Conmients:  Use  the  ABORT_SCRIPT  keystroke  to  abort  the  script  before  it 

starts  running. 

Command:  EXIT  -  Exit  the  AIM. 
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EXIT 


AIM  AIM  AIM  CLI  Running 

AIM>  SCRIPT  "demoI2 .aim" 

AIM> 

Aborted  execution  of  script  file:  : USER1 : ATB : AIM : TESTING : DEMOl 2 . AIM 
AIM>  EXIT 


AF 


BOTTOM- OF - SCREEN 


Comments:  This  session  is  <~  ;er  so  enter  the  exit  command.  The  on 

keystroke  not  demonstrated  was  the  NEXT_PAGE  keystroke.  It  will 
demonstrated  in  Session  4. 

Command:  N one. 
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A. 4  SESSION  4  -  WINDOW  RELATED  COMMANDS 

The  following  AIM  command  session  demonstrates  the  use  of  the  window 
related  AIM  commands,  namely,  SET  and  RESET.  The  following  text  files 
are  used  in  this  session: 

1.  demoil. aim 

CREATE  IMAGE  IMAGE_1 
CREATE  WINDOW  WINDOW_A 

CREATE  WINDOW  WINDOW_B 

CREATE  WINDOW  WINDOW_C 

ASSOC  W I NDOW_A  IMAGE_1  1  8 

ASSOC  WINDCW_3  IMAGE_1  9  8 

ASSOC  WINDOW_C  IMAGE_1  17  8 

RESET  A I M_SUSPENDS 

2.  jabberwocky 

JABBERWOCKY  by  Lewis  Carol 

'Twas  briilig,  and  the  slithy  toves 
Did  gyre  and  girnble  in  the  wabe: 

All  mimsy  were  the  borogoves. 

And  the  mome  raths  outgrabe. 

"Beware  the  Jabberwock,  my  son! 

The  jaws  that  bite,  the  claws  that  catch! 

Beware  the  Jubjub  bird,  and  shun 
The  frumious  Bandersnatch ! " 

He  took  his  vorpal  sword  in  hand: 

Long  time  the  manxome  foe  he  sought-- 
So  rested  he  by  the  Tumtum  tree. 

And  stood  awhile  in  thought. 

And,  as  in  uffish  thought  he  stood, 

The  Jabberwock,  with  eyes  of  flame, 

Came  whiffling  through  the  tulgey  wood, 

And  burbled  as  it  caae! 

One,  two!  One,  two!  And  through  and  through 
The  vorpal  blade  went  snicker-snack! 

He  left  it  dead,  and  with  its  head 
He  went  galumphing  back. 

"And  has  thou  slain  the  Jabberwock? 

Come  to  my  arms,  my  beamish  boy! 

0  frabjous  day!  Callooh!  Callay!" 

He  chortled  in  his  joy. 
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'Twas  brillig,  and  the  slithy  toves 
Did  gyre  and  gimDle  in  the  vabe: 

All  mimsy  were  the  borogoves, 

And  the  mome  raths  outgrabe. 

3.  mabell 

"The  Day  Bell  System  Died"  by  Lauren  Weinstein 

Long,  long,  time  ago, 

I  can  still  remember. 

When  the  local  calls  were  "free". 

And  I  knew  if  I  paid  my  bill, 

And  never  wished  them  any  ill. 

That  the  phone  company  would  let  me  be... 

But  Uncle  Sam  said  he  knew  better, 

Split  'em  up,  for  all  and  ever! 

We'll  foster  competition: 

It's  good  capital-ism! 

I  can't  remember  if  I  cried, 

When  my  phone  bill  first  tripled  in  size. 

But  something  touched  me  deep  inside, 

The  day...  Bell  System...  died. 

And  we  were  singing... 

Bye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 

"Our  local  calls  have  us  in  hock!"  we  all  cry. 

Oh  Ma  Bell  why  did  you  have  to  die? 

Ma  Bell  why  did  you  have  to  die? 

Is  your  office  Step  by  Step, 

Or  have  you  gotten  some  Crossbar  yet? 

Everybody  used  to  ask... 

Oh,  is  TSPS  coming  soon? 

IDDD  will  be  a  boon! 

And,  I  hope  to  get  a  Touch-Tone  phone,  real  soon... 

The  color  phones  are  really  neat, 

And  direct  dialing  can't  be  beat! 

My  area  code  is  "low": 

The  prestige  way  to  go! 

Oh,  they  just  raised  phone  booths  to  a  dime! 

Well,  I  suppose  it's  about  time. 

I  remember  how  the  payphones  chimed. 
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The  day...  Bell  System...  died. 

And  we  were  singing... 

Bye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 
"Our  local  calls  have  us  in  hock!"  we  all  cry. 
Oh  Ma  Bell  why  did  you  have  to  die? 

Ma  Bell  why  did  you  have  to  die? 

Back  then  we  were  all  at  one  rate, 

Phone  installs  didn't  cause  debate, 

About  who'd  put  which  wire  where... 

Installers  came  right  out  to  you. 

No  "phone  stores"  with  their  ballyhoo, 

And  411  was  free,  seemed  very  fair! 

But  FCC  wanted  it  seems, 

To  let  others  skim  long-distance  creams, 

No  matter  'bout  the  locals, 

They're  mostly  all  just  yokels! 

And  so  one  day  it  came  to  pass. 

That  the  great  Bell  System  did  collapse, 

In  rubble  now,  we  all  do  mass, 

The  day...  Bell  System...  died. 

So  bye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 
"Our  local  calls  have  us  in  hock!"  we  all  cry. 
Oh  Ma  Bell  why  did  you  have  to  die? 

Ma  Bell  why  did  you  have  to  die? 

I  drove  on  out  to  Murray  Hill, 

To  see  Bell  Labs,  some  time  to  kill, 

But  the  sign  there  said  the  Labs  were  gone. 

I  went  back  to  my  old  CO, 

Where  I'd  had  my  phene  lines,  years  ago, 

But  it  was  empty,  dark,  and  ever  so  forlorn... 

No  relays  pulsed, 

No  data  crooned, 

No  MF  tones  did  play  their  tunes, 

There  wasn't  a  word  spoken. 

All  carrier  paths  were  broken... 

And  so  that's  how  it  all  occurred, 

Microwave  horns  just  nests  for  birds, 
Everything  became  so  absurd. 
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The  day...  Bell  System...  died. 

So  bye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 
"Our  local  calls  have  us  in  hock!"  we  all  cry. 
Oh  Ma  Bell  why  did  you  have  to  die? 

Ma  Bell  why  did  you  have  to  die? 

We  were  singing: 

Bye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 
"Our  local  calls  have  us  in  hock!"  we  all  cry. 

Oh  Ma  Bell  why  did  you  have  to  die? 


4.  adalrm 


Foreword 


Ada  is  the  result  of  a  collective  effort  to  design  a  common  language  for 
programming  large  scale  and  real-time  systems. 

The  common  high  order  language  program  began  in  1974.  The  requirements  of 
the  United  States  Department  of  Defense  were  formalized  in  a  series  o: 
documents  which  were  extensively  reviewed  by  the  Services,  industrial 
organizations,  universities,  and  foreign  military  departments.  The  A do 
language  was  designed  in  accordance  with  the  final  (1978)  form  of  these 
requirements,  embodied  in  the  Steelman  specification. 

The  Ada  design  team  was  led  by  Jean  D.  Ichbiah  and  has  included  Bernd 
Kr ieg-3rueckner ,  Brian  A.  Wichmann,  Henry  F.  Ledgard,  Jean-Claude  Heliard, 
Jean-Loup  Gailly,  Jean-Raymond  Abrial,  John  G.P.  Barnes,  Mike  Woodcer, 
Olivier  Roubine,  Paul  N.  Hilfinger,  and  Robert  Firth. 

At  various  stages  of  the  project,  several  people  closely  associated  with 
the  design  team  made  major  contributions.  They  include  J.B.  Goodenough, 
R.F.  Brender,  M.W.  Davis,  G.  Ferran,  K.  Lester,  L.  MacLaren,  E.  Morel,  I.R. 
Nassi,  I.C.  Pyle,  S.A.  Schuman,  and  S.C.  Vestal. 

Two  parallel  efforts  that  were  started  in  the  second  phase  of  this  design 
had  a  deep  influence  on  the  language.  One  was  the  development  of  a  formal 
definition  using  denotational  semantics,  with  the  participation  of  v. 
Donzeau-Gouge ,  G.  Kahn,  and  B.  Lang.  The  other  was  the  design  of  a  test 
translator  with  the  participation  of  K.  Ripken,  P.  Bouilier,  P.  Cadiou,  J. 
Holden,  J.F.  Hueras,  R.G.  Lange,  and  D.T.  Cornhill.  The  entire  effort 
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benefitted  from  the  dedicated  assistance  of  Lyn  Churchill  and  Marion  Myers, 
and  the  effective  technical  support  or  B.  oravem,  W.L.  Heimerdinger ,  and 
P.  Cleve.  H.G.  Schmitz  served  as  program  manager. 

Over  the  five  years  spent  on  this  project,  several  intense  week-long  design 
reviews  were  conducted,  with  the  participation  of  P.  Belmont,  B.  Brosgol, 
P.  Cohen,  R.  Dewar,  A.  Evans,  G.  Fisher,  H.  Harte,  A.L.  Hisgen,  P.  Knueven, 
M.  Kronental,  N.  Lomuto,  E.  Ploedereder,  G.  Seegmueller,  V.  Stenning,  D. 
Taffs,  and  also  F.  Belz,  R.  Converse,  K.  Correll,  A.N.  Habermann,  J. 
Sammet,  S.  Squires,  J.  Teller,  P.  Wegner,  and  P.R.  Wetherall. 


I 
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INVOKE  AIM  FROM  APSE 

-)  AIM 


_ BOTTOM-OF- SCREEN _ 

Comments : 

Command:  AIM  -  invoke  the  AIM  from  the  APSE. 
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MAIN  MAIN 

AOS/VS  CLI  REV  05.01.00.00 


SWITCH  TO  AIM  IMAGE 
FRCH:016  Running 

9- APR-8  5  13:  26:43 


{ F10 } 


AF 


BOTTOM-OF-SCREEN 


Comments:  The  AIM  initializes  the  current  image  to  be  MAIN.  To  enter  AIM 
textual  commands  the  user  must  communicate  through  the  AIM  image  to  the  AIM 
command  interpreter. 

Command:  { F 1 0 }  -  Set  the  current  image  to  be  the  AIM  image. 
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INVOKE  SCRIPT 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  SCRIPT  "demoll. aim" 


BOTTOM-OF-SCREEN 


Comments:  Control  has  been  passed  to  the  AIM  command  interpreter  in  the 

AIM  window. 

Command:  SCRIPT  "demoll. aim"  -  Invoke  a  script.  The  demoll. aim  script 

initializes  the  AIM  environment  to  be  used  in  this  AIM  command  session. 
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ECHO  SCRIPT  LINES 

AIM  AIM  AIM  CLI  Running 

AIM>  SCRIPT  "demoll. aim" 

AIM>  CREATE  IMAGE  IMAGE_1 

AIM>  CREATE  WINDOW  WINDOW_A 

AIM>  CREATE  WINDOW  WINDOW_B 

AIM>  CREATE  WINDOW  WINDOW_C 

AIM>  ASSOC  W I NDOW_ A  IMAGE_1  1  8 

AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 

AIM>  RESET  AIM_SUSPENDS 
AIM>  GOTO  IMAGE  IMAGE  1 


BOTTOM-OF-SCREEN 


Comments:  The  command  lines  of  the  script  file  are  individually  echoed 

back  to  the  console  as  they  are  read  and  interpreted. 

Command:  GOTO  IMAGE  IMAGE_1  Position  the  cursor  in  the  top  viewport  of 

IMAGE  1. 
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CURRENT  IMAGE  ON  SCREEN  IS  IMAGE__1 

IMAGE_1  W I NDOW_A  FRCH:017  Running  F 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29  {F10} 


IMAGE_1 
AOS/VS  CLI 


W I NDOW_B 
REV  05.01.00.00 


FRCH:018  Running 

ll-APR-85  8:55:29 


F 


IMAGE_1 
AOS/VS  CLI 


W I NDOW_C 
REV  05.01.00.00 


FRCH:019  Running 

ll-APR-85  8:55:29 


F 


BOTTOM-OF-SCREEN 


Conunents:  The  cursor  was  positioned  in  the  first  viewport  of  IMAGE_i. 
Each  window  is  executing  its  own  APSE  process,  namely  the  APSE  command 
interpreter;  thus,  the  APSE  command  interpreter  prompt,  " ) " ,  appears  in 
WINDOW_A,  WINDOW_B,  and  WINDOW_C.  Note  that  each  viewport  header  displays 
the  default  flag  settings  for  the  windows  ("AF"). 

Command:  { F 1 0 }  Switch  control  back  to  the  AIM  command  interpreter  in  the 
AIM  window. 
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RESET  FULL  COMMAND 


AIM  AIM  AIM  CLI 

AIM>  SCRIPT  "demoll. aim" 

AIM>  CREATE  IMAGE  IMAGE_1 

AIM>  CREATE  WINDOW  WINDOW_A 

AIM>  CREATE  WINDOW  WINDOW_B 

AIM>  CREATE  WINDOW  WINDOW_C 

AIM>  ASSOC  W I NDOW_ A  IMAGE_1  1  8 

AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 

AIM>  RESET  AIM_SUSPENDS 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  RESET  FULL  WINDOW  B 


Running 


F 


BOTTOM-OF-SCREEN 


Comments:  The  AIM  window  flag  settings  have  changed  due  to  the  RESET  AIM 
command.  For  every  window,  the  default  value  of  the 
SUSPENDS_OUTPUT_WHEN_FULL  flag  is  TRUE;  thus,  by  default,  the  associated 
APSE  program  output  will  be  suspended  when  an  entire  window  of  data  has 
been  generated. 

Command:  RESET  FULL  WINDOW_B  -  Turn  off  the  SUSPENDS_OUTPUT_WHEN_FULL  flag 
for  WINDOW_B  allowing  continuous  scrolling  of  the  output  generated  by  the 
APSE  program  associated  with  WINDOW_B. 
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SET  PADS  FOR  AIM  WINDOW 


AIM  AIM  AIM  CLI 

AIM>  SCRIPT  "demoll. aim" 

AIM>  CREATE  IMAGE  IMAGE_1  . 

AIM>  CREATE  WINDOW  WINDOW_A 

AIM>  CREATE  WINDOW  WIND0W_3 

AIM>  CREATE  WINDOW  WINDOW_C 

AIM>  ASSOC  W I NDOW_A  IMAGE_I  1  8 

AIM>  ASSOC  W I NDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 

AIM>  RESET  AIM_SUSPENDS 

AIM>  GOTO  IMAGE  IMAGE_1 

AIM>  RESET  FULL  WINDOW_B 

AIM>  SET  PADS  AIM 


Running 


F 


BOTTOM-OF-SCREEN 


Comments:  The  FULL  flag  has  been  set  for  WINDOW_B. 

Command:  SET  PADS  AIM  -  Activate  both  an  input  and  output  pad  file  for 

logging  the  activity  of  the  AIM  window. 
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AIM  CLI 


AIM>  SCRIPT  "demoll. aim" 

AIM>  CREATE  IMAGE  IMAGE_1 
AIM>  CREATE  WINDOW  WINDOW_A 
AIM>  CREATE  WINDOW  WINDOW_B 
AIM>  CREATE  WINDOW  WINDOW_C 
AIM>  ASSOC  WINDOW_A  IMAGE_1 
AIM>  ASSOC  WINDOW_B  IMAGE_1 
AIM>  ASSOC  WINDOW  C  IMAGE  1 


Runn l ng 


AIM>  RESET  AIM_SUSPENDS 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  RESET  FULL  WINDOW_B 
AIM>  SET  PADS  AIM 

**AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM : TEST  I NG : AIM1 . I NP 
**AIM  generated  output  pad  file  name:  :USER1 : ATB: AIM:TESTING: AIMl .OUT 
AIM>  SET  INPUT  PAD  WINDOW  A 


BOTTOM-OF-SCREEN 


Comments:  The  SET  PADS  AIM  command  is  now  complete  as  both  the  input  and 
output  pad  file  names  have  been  supplied  by  the  AIM.  Note,  the  AIM  window 
flag  settings  have  changed  to  "FIO"  indicating  to  the  user  that  both  ar. 
input  and  output  pad  file  are  currently  associated  with  the  AIM  window. 


Command:  SET  INPUT_PAD  WINDOW_A  -  Activate  a 

input  activity  of  WINDOW  A. 


file  for  logging  the 
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SET  OUTPUT  PAD  FOR  WINDOW  P 


AIM  AIM  AIM  CLI 

AIM>  SCRIPT  "demoll. aim" 

AIM>  CREATE  IMAGE  IMAGE_1 

AIM>  CREATE  WINDOW  WINDOW_A 

AIM>  CREATE  WINDOW  WINDOW_B 

AIM>  CREATE  WINDOW  WINDOW_C 

AIm>  ASSOC  WINDOW_A  IMAGE_1  1  8 

AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  WINDOW_C  IMAGE_1  17  8 

AIM>  RESET  AIM_SUSPENDS 

AIM>  GOTO  IMAGE  IMAGE_1 

AJM>  RESET  FULL  WINDOW_B 

AIM>  SET  PADS  AIM 

**AIM  generated  input  pad  file  name: 
* *AIM  generated  output  pad  file  name 
AIM>  SET  INPUT_PAD  WINDOW_A 
**AIM  generated  input  pad  file  name: 
AIM>  SET  OUTPUT  PAD  WINDOW  B 


Running 


FIC 


:  USER1 : ATB : A IM : TESTING : AIMI . INP 
:  USER1 :  ATB:  AIM  .-TESTING:  AIM2  .OUT 

:  USER 1 : ATB : AIM : TESTING : WINDOW  A3 . INP 


BOTTOM-OF-SCREEN 


Comments:  The  SET  INPUT_PAD  command  is  now  complete  as  the  AIM  supplied  a 

file  name  for  WINDOW_A's  input  pad. 

Command:  SET  OUTPUT_PAD  WIND0W_B  -  Activate  a  pad  file  for  logging  the 

output  activity  of  WINDOW_B. 
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SPECIFY  OUTPUT  PAD  NAME 


AIM  AIM  AIM  CLI 

AIM>  SCRIPT  "demoll .aim" 

AIM>  CREATE  IMAGE  IMAGE_1 

AIM>  CREATE  WINDOW  WINDOW_A 

AIM>  CREATE  WINDOW  WINDOW_B 

AIM>  CREATE  WINDOW  WINDOW_C 

AIM>  ASSOC  W I NDOW_A  IMAGE_1  1  8 

AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  WINDOW_C  IMAGE_1  17  8 

AIM>  RESET  AIM_SUSPENDS 

AIM>  GOTO  IMAGE  IMAGE_1 

AIM>  RESET  FULL  WINDOW_B 

AIM>  SET  PADS  AIM 

**AIM  generated  input  pad  file  name: 

* *AIM  generated  output  pad  file  name: 
AIM>  SET  INPUT_PAD  WINDOW_A 
*  * AIM  generated  input  pad  file  name: 
AIM>  SET  OUTPUT_PAD  WINDOW_B 
**AIM  generated  output  pad  file  name: 
AIM>  SET  PADS  WINDOW  C 


Running 


FIO 


:  USERl: ATB: AIM: TESTING : AIMl . INP 
: USERl : ATB : AIM : TESTING : AIM2 . OUT 

:  USER1 : ATB : A I M : TEST I NG : W I NDOW_A3 . INP 

: USERl: ATB: AIM: TESTING :WINDOWB  4 .OUT 


BOTTOM-OF-SCREEN 


Comments:  The  AIM  is  providing  the  specification  of  an  output  pad  file 

name  for  WIND0W_B. 

Command:  SET  PADS  WINDOW  C 
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SET  PADS  FOR  WINDOW  C 


AIM 

AIM 

AIM  CL 

,1 

AIM> 

SCRIPT 

"demoll . 

aim" 

AIM> 

CREATE 

IMAGE 

IMAGE  1 

AIM> 

CREATE 

WINDOW 

WINDOW 

A 

AIM> 

CREATE 

WINDOW 

WINDOW 

B 

AIM> 

CREATE 

WINDOW 

WINDOW 

C 

AIM> 

ASSOC 

WINDOW  A 

IMAGE 

1 

1 

8 

AIM> 

ASSOC 

WINDOW  B 

IMAGE 

1 

9 

8 

AIM> 

ASSOC 

WINDOW  C 

IMAGE 

1 

17 

8 

AIM> 

RESET  , 

MM  SUSPENDS 

AIM> 

GOTO  IMAGE  IMAGE  1 

AIM> 

RESET  i 

FULL  WINDOW  B 

AIM> 

SET  PADS  AIM 

**AIM  generated  input  pad  file  name: 

**AIM  generated  output  pad  file  name: 

AIM>  SET  INPUT_PAD  WINDOW_A 

**AIM  generated  input  pad  file  name: 

AIM>  SET  OUTPUT_PAD  WINDOW_B 

**AIM  aenerated  output  pad  file  name: 

AIM>  SET  PADS  WINDOW_C 

**AIM  generated  input  pad  file  name: 

**AIM  generated  output  pad  file  name: 

AIM>  GOTO  IMAGE  IMAGE  1 


Running  FIO 


USERl : ATB : AIM: TESTING : AIM1 . INP 
:USER1: ATB: AIM: TESTING: AIM2 .OUT 

USERl : ATB : A I M : TEST I NG : W I NDOW_ A  3 . I NP 

: USERl : ATB : AIM : TEST  I NG : W I NDOW_B4 . OUT 

USERl : ATB: AIM: TESTING :WINDOW_C5. INP 
: USERl : ATB : AIM : TEST I NG : WINDOW  C6 . OUT 


BOTTOM-OF-SCREEN 


Comments:  The  SET  OUTPUT_PAD  command  is  now  complete  as  the  AIM  supplied  a 

file  name  for  WINDOW_C's  pads. 

Command:  GOTO  IMAGE  IMAGE  1 
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LIST  A  FILE  IN  WINDOW_A 

IMAGE_1  WINDOvTa  FRCH: 017  Running  Fl 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29  TYPE  JAB. AIM 


IMAGE_1  WINDOW_B  FRCH: 018  Running  O 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29 


IMAGE_1  W I NDOW_C  FRCH: 019  Running  FIO 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29 


BOTTOM-OF-SCREEN 


Comments:  The  window  flag  settings  have  changed  as  a  direct  result  of  the 
RESET  AIM,  RESET  FULL  WINDOW_B,  SET  INPUT_PAD  WINDOW_A,  SET  OUTPUT_PAD 
WINDOW_B ,  and  SET  PADS  WINDOW_C  commands.  WINDOW_A  ("FI")  has  the  FULL 
flag  set  (default)  and  its  input  pad  activated.  WINDOW_B  ("O")  has  the 
FULL  flag  turned  off  and  itr.  output  pad  activated.  WINDOW_C  ("FIO")  has 
the  FULL  flag  set  (default)  and  both  its  input  and  output  pads  activated. 

Command:  TYPE  JAB. AIM  -  List  the  contents  of  the  file  jab. aim  in  WlNDOW_A. 
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SWITCH  TO  THE  PRECEDING  VIEWPORT  ON  IMAGE_1 

IMAGE_I  W I NDOW_A  FRCH : 0 1 7  Running  FT 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29  TYPE  JAB. AIM 

TYPE  JAB. AIM 

JABBERWOCKY  by  Lewis  Carol 

'Twas  brillig,  and  the  slithy  toves  {F7} 

Did  qyre  and  gimble  in  the  wabe: 

IMAGE_1  W I NDOW_B  FRCH: 013  Running  FO 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29 


IMAGE_1  W I NDOW_C 

AOS/VS  CLI  REV  05.01.00.00 


FRCH :C 19 


Runn i ng 


ll-APR-85  8:55:29 


F IO 


BOTTOM-OF-SCREEN 


Comments:  The  listing  of  the  " jabberwocky"  file  commences  in  WINDOW_A  and 

then  the  user  enters  the  PREVlOUS_VlEWPORT  keystroke. 

Command:  {F7}  -  Switch  to  the  preceding  viewport  on  IMAGE_1. 
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LIST  ANOTHER  FILE  IN  WINDOW_C 

IMAGE_1  W I  NDOW_  A  FRCHTSTt  Running  More.".  FI 

So  rested  he  by  the  Tumtum  tree. 

And  stood  awhile  in  thought. 

And,  as  in  uffish  thought  he  stood, 

The  Jabberwock,  with  eyes  of  flame, 

Came  wif fling  through  the  tulgey  wood, 

And  burbled  as  it  came! 

IMAGE_1  WINDOW_B  FRCHi018  Running  0 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29 


IMAGE_1  W I NDOW_C  FRCH:019  Running  FIO 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29  TYPE  LRM.AIM 


BOTTOM-OF-SCREEN 


Comments:  The  preceding  viewport  is  the  third  one  since  the 
VIEWPORT  MANAGER  considers  an  image  a  circular  list  of  viewports.  Note  the 
last  7  lines  of  WINDOW_A  are  listed  in  the  first  viewport  and  the  "More.." 
flag  is  turned  on  since  there  is  more  than  one  window  full  of  text  in  the 
" jabberwocky"  file.  The  cursor  is  positioned  at  the  top  of  the  viewport 
associated  with  WIND0W_C. 

Command:  TYPE  LRM.AIM  -  List  the  contents  of  "adalrm"  in  WINDOW  C. 
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SWITCH  TO  PRECEDING  VIEWPORT 


IMAGE_I  W I NDOW_ A  FRCH:017  Running  More..  FI 

So  rested  he  by  the  Tumtum  tree. 

And  stood  awhile  in  thought. 

And,  as  in  uffish  thought  he  stood, 

The  Jabberwock,  with  eyes  of  flame, 

Came  wiffling  through  the  tulgey  wood, 

And  burbled  as  it  came! 

IMAGE_1  WINDCW_3  FRCH:018  Running  0 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29 


IMAGE  1 


WINDOW  C  FRCH: 019 


Running 


F 1 0 


AOS/VS  CLI  REV  05.01.00.00 
TYPE  LRM.AIM 


ll-APR-85 

Foreword 


8:55:29  TYPE  LRM.AIM 


Ada  is  the  result  of  a  collective  effort  to  design  a  common  language 
programming  large  scale  and  real-time  systems.  {F7} 

BOTTOM- OF - SCREEN 


Comments:  The  listing  of  the  "adalrm"  file  commences  in  wiNDOW_c  as  the 
user  enters  the  PREVIOUS_VlEWPORT  keystroke. 

Command:  {F7}  -  Switch  to  the  preceding  viewport  on  IMAGE_1. 
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LIST  A  FILE  IN  WINDOW_B 

IMAGE_1  W I NDOW_A  FRCH ; 0 i 7  Runn i ng  More . .  FI 

So  rested  he  by  the  Tumtum  tree, 

And  stood  awhile  in  thought. 

And,  as  in  uffish  thought  he  stood. 

The  Jabberwock,  with  eyes  of  flame, 

Came  wiffling  through  the  tulgey  wood. 

And  burbled  as  it  came! 

IMAGE_1  windqw_b  FRCH:018  Running  0 

AOS/VS  CLI  REV  05.01.00.00  11 -APR- 8 5  8:55:29  TYPE  MABELL .AIM 

TYPE  MABELL. AIM 

"The  Day  Bell  System  Died"  by  Lauren  Weinstein 

Long,  long,  time  ago, 

I  can  still  remember, 

IMAGE_1  WINDOW_C  FRCH:019  Runring  More..  FIO 

The  Ada  design  team  was  led  by  Jean  D.  Ichbiah  and  has  included  Bernd 
Kr ieg-Brueckner ,  Brian  A.  Wichmann,  Henry  F.  Ledgard,  Jean-Claude  Heliard, 
Jean-Loup  Gailly,  Jean-raymond  Abrial,  John  G.P.  Barnes,  Mike  Woodger, 
Olivier  Roubine,  Paul  N.  Hilfinger,  and  Robert  Firth. 

At  various  stages  of  the  project,  several  people  closely  associated  with 

BOTTOM -OF-SCREEN 


Comments:  Note  the  last  7  lines  of  WINDOOW_C  are  listed  in  the  third 
viewport  and  the  "More.."  flag  is  turned  on  since  there  is  more  than  one 
window  full  of  text  in  the  "adalrm"  file.  The  cursor  is  positioned  at  the 
top  of  the  viewport  associated  with  WINDOW_B. 

Command:  TYPE  MABELL. AIM  -  List  the  contents  of  "mabell"  in  WINDOW  B. 
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SWITCH  TO  AIM  WINDOW 

IMAGE_1  WINDOW_A  FRCH: 017  Running  More.  .  FI 

So  rested  he  by  the  Tumtum  tree, 

And  stood  awhile  in  thought. 

And,  as  in  uffish  thought  he  stood. 

The  Jabberwock,  with  eyes  of  flame, 

Came  wiffling  through  the  tulgey  wood, 

And  burbled  as  it  came! 

IMAGE_1  WINDOW_B  FRCH: 018  Running  0 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29  TYPE  MABELL .AIM 

TYPE  MABELL. AIM 

"The  Day  Bell  System  Died"  by  Lauren  Weinstein 

Long,  long,  time  ago, 

I  can  still  remember,  { F 1 0  > 

IMAGE_1  WINDOW_C  FRCH:019  Running  More..  FIO 

The  Ada  design  team  was  led  by  Jean  D.  Ichbiah  and  has  included  Bernd 
Kr  ieg-Brueckner ,  Brian  A.  Wichmann,  Henry  F.  Ledgard,  Jean-Claude  Heliarc, 
Jean-Loup  Gailly,  Jean-raymond  Abrial,  John  G.P.  Barnes,  Mike  Woodger, 
Olivier  Roubine,  Paul  N.  Hilfinger,  and  Robert  Firth. 

At  various  stages  of  the  project,  several  people  closely  associated  with 

BOTTOM-OF-SCREEN 


Comments:  The  listing  of  the  "mabell"  file  is  executing  in  WIND0W_B  as  the 

user  enters  the  SWITCHj_TO_AIM  keystroke. 

Command:  {F10}  -  Switch  the  input  context  to  the  AIM  window  in  order  to 

communicate  with  the  AIM  command  interpreter. 
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RESET  INPUT_PAD  WINDOW_A 

AIM  AIM  AIM  CLI  Running  Flo- 

AIM>  SCRIPT  "demoll. aim" 

AIM>  CREATE  IMAGE  IMAGE_1 

AIM>  CREATE  WINDOW  WINDOW_A 

AIM>  CREATE  WINDOW  WINDOW_B 

AIM>  CREATE  WINDOW  WINDOW_C 

AIM>  ASSOC  W I NDOW_A  IMAGE_1  1  8 

AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 

AIM>  RESET  AIM_SUSPENDS 

AIM>  GOTO  IMAGE  I MAGE_ 1 

AIM>  RESET  FULL  WINDOW_B 

AIM>  SET  PADS  AIM 

*  "AIM  generated  input  pad  file  name:  :USER1 :  ATB:  AIM  .'TESTING :  A IM1 .  INP 
* "AIM  generated  output  pad  file  name:  :USER1:ATB:AIM:TESTING:AIM2.0UT 
AIM>  SET  INPUT  PAD  WINDOW_A 

"♦AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TESTING : WIND0W_A3 . INP 
AIM>  SET  OUTPUT_PAD  WINDOW_B 

""AIM  generated  output  pad  file  name:  : USER1 : ATB : AIM: TEST  I NG : WI NDOW_B4 . OUT 
AIM>  SET  PADS  WINDOW_C 

""AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TESTING :WINDOW_C 5 . INP 
""AIM  generated  output  pad  file  name:  :USER1 : ATB: AIM;TESTING:WINDOW_C6 .OUT 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  RESET  INPUT_PAD  WINDOW_A 

BOTTCM-OF-SCREEN 


Comments:  Control  has  returned  to  the  AIM  command  interpreter  in  the  AIM 

window. 

Command:  RESET  INPUT_PAD  WINDOW_A  -  Turn  off  the  recording  of  WlNDOW_A's 

input. 
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RESET  OUTPUT  PAD  WINDOW  B 


AIM  AIM  AIM  CLI 

AIM>  CREATE  IMAGE  IMAGE_1 
AIM>  CREATE  WINDOW  WINDOW_A 
AIM>  CREATE  WINDOW  WINDOW_B 
AIM>  CREATE  WINDOW  WINDOW_C 
AIM>  ASSOC  W I NDOW_A  IMAGE_1  1 
AIM>  ASSOC  W I NDOW_B  IMAGE_I  9 
AIM>  ASSOC  W I NDOW_C  IMAGE_1  17 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  RESET  AIM_SUSPENDS 
AIM>  RESET  FULL  WINDOW_B 
AIM>  SET  PADS  AIM 


Running 


8 

8 

8 


FIO 


**AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TESTI NG : AIMl . I NP 
**AIM  generated  output  pad  file  name:  :USER1:ATB:AIM:TESTING:AIM2.0UT 
AIM>  SET  INPUT  PAD  WINDOW_A 

**AIM  generated  input  pad  file  name:  :USER1 : ATB: AIM: TESTING :WINDOW_A3 .  INP 
AIM>  SET  OUTPUT_PAD  WINDOW_B 

**AIM  generated  output  pad  file  name:  :USER1 : ATB: AIM:TESTING:WINDOW  A4 .OUT 
AIM>  SET  PADS  WINDOW_C 

**AIM  generated  input  pad  file  name:  :USER1 : ATB: AIM: TESTING :WINDOW_C5 .  INP 

**AIM  generated  output  pad  file  name:  :USERl:ATB:AIM:TESTING:WINDOW  C6.0UT 

AIM>  GOTO  IMAGE  IMAGE_1 

AIM>  RESET  I NPUT_P AD  WINDOW_A 

AIM>  RESET  OUTPUT_PAD  WINDOW_B 

_  _  BOTTOM-OF-SCREEN 


Comments:  WINDOW_A's  input  pad  has  been  deactivated. 

Command:  RESET  OUTPUT_PAD  WIND0W_B  -  Turn  off  the  recording  of  WINDOW_B's 

output.  ~ 
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More 

“AIM  ATM  AIM  CLI  Running  More. .  Flo- 

AIM>  CREATE  IMAGE  IMAGE_1 

AIM>  CREATE  WINDOW  WINDOW_A 

AIM>  CREATE  WINDOW  WINDOW_B 

AIM>  CREATE  WINDOW  WINDOW_C 

AIM>  ASSOC  W I NDOW_A  IMAGE_1  1  8 

AIM>  ASSOC  W I NDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  WINDOW_C  IMAGE_1  17  8 

AIM>  RESET  A I M_SUSPENDS 

AIM>  GOTO  IMAGE  IMAGE_1 

AIM>  RESET  FULL  WINDOW_B 

AIM>  SET  PADS  AIM 

* *AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TESTING : AIM1 . INP 
* *AIM  generated  output  pad  file  name:  : USER1 : ATB : AIM: TESTING: AIM2 . OUT 
AIM>  SET  INPUT  PAD  WINDOW_A 

**AIM  generated  input  pad  file  name:  :USER1 : ATB : AIM: TESTING :WIND0W_A3 . INP 
AIM>  SET  OUTPUT_PAD  WINDOW_B 

**AIM  generated  output  pad  file  name:  : USER1 : ATB : AIM : TESTING : WINDOW_B4 . OUT 
AIM>  SET  PADS  WINDOW_C 

* *AIM  generated  input  pad  file  name:  : USER1 : ATB: AIM: TESTING :WINDOW_C5 . INP 

**AIM  generated  output  pad  file  name:  :USER1 : ATB: AIM: TESTING :WINDOW_C6 .OUT 

AIM>  GOTO  IMAGE  IMAGE_1 

AIM>  RESET  INPUT  PAD  WINDOW_A 

AIM>  RESET  OUTPUT_PAD  WINDOW_B  { F4 } 

BOTTOM-OF-SCREEN 


Comments:  More  flag  set 

Command:  { F4 } 
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RESET  PADS  WINDOW  C 


AIM 

AIM> 

AIM> 

AIM> 

CREATE 

CREATE 

CREATE 

AIM 

WINDOW 

WINDOW 

WINDOW 

AIM  CLI 
WINDOW  A 
WINDOW  B 
WINDOW  C 

Running 

AIM> 

ASSOC 

WINDOW  A 

IMAGE  1 

1 

8 

AIM> 

ASSOC 

WINDOW  B 

IMAGE  1 

9 

3 

AIM> 

AIM> 

AIM> 

AIM> 

AIM> 

ASSOC  WINDOW  C  IMAGE  1 
RESET  AIM  SUSPENDS 

GOTO  IMAGE  IMAGE  1 

RESET  FULL  WINDOW  B 

SET  PADS  AIM 

17 

8 

FIO 


**AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TEST  I NG : AIM1 . INP 
**AIM  generated  output  pad  file  name:  :USER1 : ATB: AIM:TESTING: AIM2 .OUT 
AIM>  SET  INPUT_PAD  WINDOW_A 

**AIM  generated  input  pad  file  name:  :USER1 : ATB: AIM:TESTING:WIND0W_A3 . INP 
AIM>  SET  OUTPUT_PAD  WINDOW_B 

**AIM  generated  output  pad  file  name:  :USER1 : ATB: AIM:TESTING:WIND0W_A4 .OUT 
AIM>  SET  PADS  WINDOW_C 

**AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TESTING : WINDOW_C5 . I NP 

**AIM  generated  output  pad  file  name:  :USER1: ATB: AIM: TESTING :WIND0W_C6 .OUT 

AIM>  GOTO  IMAGE  IMAGE_1 

AIM>  RESET  I NPUT_P AD  WINDOW_A 

AIM>  RESET  OUTPUT_PAD  WINDOW_B 

AIM>  RESET  PADS  WINDOW_C 

_  BOTTOM-OF-SCREEN 


Comments:  WlNDOW_B’s  output  pad  has  been  deactivated. 

Command:  RESET  PADS  WINDOW_C  -  Turn  off  the  recording  of  WINDOW_C's  input 

and  output . 
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SET  FULL  W I NDOW_B 

AIM  AIM  AIM  CLI  Running  AF 

AIM>  CREATE  WINDOW  WINDOW_B 

AIM>  CREATE  WINDOW  WINDOW_C 

AIM>  ASSOC  W I NDOW_ A  IMAGE_1  1  8 

AIM>  ASSOC  W I NDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 

AIM>  RESET  AIM_SUSPENDS 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  RESET  FULL  WINDOW_B 
AIM>  SET  PADS  AIM 

* *AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM : TESTING : AIMl . INP 
* *AIM  generated  outrut  pad  file  name:  : USER1 : ATB : AIM : TEST I NG : AIM2 . OUT 
AIM>  SET  INPUT_PAD  WINDOW_A 

**AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM : TESTING : WIND0W_A3 . INP 
AIM>  SET  OUTPUT_PAD  WINDOW_B 

**AIM  generated  output  pad  file  name:  : USER1 : ATB : AIM: TESTING : WINDOW_A4 . OUT 
AIM>  SET  PADS  WINDOW_C 

**AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TESTING :WINDOW_C5 . INP 

* *AIM  generated  output  pad  file  name:  :USER1: ATB: AIM {TESTING :WINDOW_C6 .OUT 

AIM>  GOTO  IMAGE  IMAGE_1 

AIM>  RESET  INPUT  PAD  WINDOW_A 

AIM>  RESET  OUTPUT_PAD  WINDOW_B 

AIM>  RESET  PADS  WINDOW_C 

AIM>  SET  FULL  WINDOW_B 

BOTTOM-OF-SCREEN 


Comments:  WlNDOW_C's  input  and  output  pads  have  been  deactivated. 

Command:  SET  FULL  WIND0W_B  -  Turn  off  continuous  scrolling  of  the  output 

generated  by  the  APSE  program  associated  with  WINDOW  B. 
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GOTO 
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■ 

AIM  AIM 

AIM  CLI 

Running 

F 10 

1 

AIM>  CREATE  WINDOW  WINDOW_C 

AIM>  ASSOC  WINDOW_A  IMAGE_1  1  8 

AIM>  ASSOC  W I NDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 

AIM>  RESET  AIM_SUSPENDS 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  RESET  FULL  WINDOW_B 
AIM>  SET  PADS  AIM 

**AIM  generated  input  pad  file  name:  :USER1 :  AT3:  AIM.-TESTING:  AIM1 .  INP 
**AIM  aenerated  output  pad  file  name:  : USER1 : ATB : AIM : TESTING : AIM2 . OUT 
AIM>  SET  INPUT_PAD  WINDOW_A 

**AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TEST I NG : WIND0W_A3 . I NP 
AIM>  SET  OUTPUT_PAD  WINDOW_B 

**AIM  generated  output  pad  file  name:  : USERl : ATB : AIM: TESTING :WINDOW_A4 . OUT 
AIM>  SET  PADS  WINDOW_C 

**AIM  generated  input  pad  file  name:  : USERl : ATB: AIM: TESTING :WIND0W_C5 . INP 

**AIM  generated  output  pad  file  name:  : USERl : ATB : AIM : TESTING : WINDOW_C6 . OUT 

AIM>  GOTO  IMAGE  IMAGE_1 

AIM>  RESET  INPUT_PAD  WINDOW_A 

AIM>  RESET  OUTPUT_PAD  WINDOW_B 

AIM>  RESET  PADS  WINDOW_C 

AIM>  SET  FULL  WINDOW_B 

A IM>  GOTO  WINDOW  WINDOW_A 

BOTTOM-OF-SCREEN 


Comments:  WINDOW_B's  APSE  program's  output  will  NOT  scroll  continuously; 

it  will  be  suspended  upon  filling  up  WINDOW_B. 

Command:  GOTO  WINDOW  WINDOW_A  -  Switch  the  input  context  to  WINDOW  A. 
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DISPLAY  THE  NEXT  PAGE  OF  INFORMATION  FOR  WINDOW_A 

IMAGE_1  WINDOW_A  FRCH : 0 1 7  Running  More. .  F 

So  rested  he  by  the  Tumtum  tree, 

And  stood  awhile  in  thought. 

And,  as  in  uffish  thought  he  stood, 

The  Jabberwock,  with  eyes  of  flame. 

Came  wiffling  through  the  tulgey  wood, 

And  burbled  as  it  came!{F4} 

IMAGE_1  WINDOW_B  FRCH: 018  Running  F 

Bye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 

"Our  local  calls  have  us  in  hock!"  we  all  cry. 

Oh  Ma  Bell  why  did  you  have  to  die? 

IMAGE_1  W I NDOW_C  FRCH:019  Running  More..  F 

The  Ada  design  team  was  led  by  Jean  D.  Ichbiah  and  has  included  Bernd 
Kr ieg-Brueckner ,  Brian  A.  Wichmann,  Henry  F.  Ledgard,  Jean-Claude  Heliard, 
Jean-Loup  Gailly,  Jean-raymond  Abrial,  John  G.P.  Barnes,  Mike  Woodger, 
Olivier  Roubine,  Paul  N.  Hilfinger,  and  Robert  Firth. 

At  various  stages  of  the  project,  several  people  closely  associated  with 

BOTTOM-OF-SCREEN 


Comments:  The  listing  of  the  "mabell"  file  has  finished  in  WINDOW_B;  the 

cursor  is  positioned  at  the  end  of  WINDOW_A's  viepwort. 

Command:  { F4 }  -  Display  the  next  window  full  of  text  available  for 

WINDOW  A. 
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GOTO  PRECEDING  VIEWPORT  ON  IMAGE_1 

IMAGE  1  W I NDOW_A  FRCH: 017  Running  F 

0  frabjous  day!  Callooh!  Callay!" 

He  chortled  in  his  joy. 

' Twas  brillig,  and  the  slithy  toves 
Did  gyre  and  gimble  in  the  wabe: 

All  mimsy  were  the  borogoves, 

And  the  mome  raths  outgrabe.  { F7 } 

IMAGE_1  W I NDOW_B  FRCH: 018  Running  F 

Bye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 

"Our  local  calls  have  us  in  hock!"  we  all  cry. 

Oh  Ma  Bell  why  did  you  have  to  die? 

IMAGE_1  W I NDOW_C  FRCH:019  Running  More..  F 

The  Ada  design  team  was  led  by  Jean  D.  Ichbiah  and  has  included  Bernd 
Kr ieg-Brueckner .  Brian  A.  Wichmann,  Henry  F.  Ledgard,  Jean-Claude  Heiiara, 
Jean-Loup  Gailly,  Jean-raymond  Abrial,  John  G.P.  Barnes,  Mike  Woodger, 
Olivier  Roubine,  Paul  N.  Hilfinger,  and  Robert  Firth. 

At  various  stages  of  the  project,  several  people  closely  associated  with 

BOTTOM-OF-SCREEN 


Comments:  The  listing  of  the  " jabberwocky"  file  has  finished,  and  the  APS 
command  interpreter  prompt  is  the  last  line  of  the  viewport.  Note  the  nex 
page  (window  full)  of  output  generated  by  the  APSE  LIST  utility  i 
displayed  (continuously  scrolled)  in  the  viewport  associated  with  WINDOW_A 

Command:  { F7 }  -  Switch  to  the  preceding  viewport  on  IMAGE_1. 
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DISPLAY  THE  NEXT  PAGE  OF  INFORMATION  FOR  WINDOW_C 

IMAGE_1  W I NDOW_A  FRCH: 017  Running  F 

He  chortled  in  his  joy. 

' Twas  brillig,  and  the  slithy  toves 
Did  gyre  and  gimble  in  the  wabe: 

All  mimsy  were  che  Lv/iogoves, 

And  the  mome  raths  outgrabe. 

IMAGE_1  WINDOW_B  FRCH:018  Running  F 

3ve,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 

"Our  local  calls  have  us  in  hock!"  we  all  cry. 

Oh  Ma  Bell  why  did  you  have  to  die? 

IMAGE_1  W I NDOW_C  FRCH:019  Running  More..  F 

The  Ada  design  team  was  led  by  Jean  D.  Ichbiah  and  has  included  Bernd 
Kr ieg-Brueckner ,  Brian  A.  Wichmann,  Henry  F.  Ledgard,  Jean-Claude  Heliard, 
Jean-Loup  Gailly,  Jean-raymond  Abrial,  John  G.P.  Barnes,  Mike  Woodger, 
Olivier  Roubine,  Paul  N.  Hilfinger,  and  Robert  Firth. 

At  various  stages  of  the  project,  several  people  closely  associated  with{F4} 

BOTTOM-OF-SCREEN 


Comments:  The  cursor  has  been  positioned  at  the  end  of  the  viewport 

associated  with  WIND0W_C. 

Command:  { F4 }  -  Display  the  next  window  full  of  text  available  for 

WINDOW  C. 
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SWITCH  TO  AIM  WINDOW 

IMAGE_1  WINDOW_A  FRCH : 0 1 7  Running  F 

He  chortled  in  his  joy. 

'Twas  brillig,  and  the  slithy  toves 
Did  gyre  and  gimble  in  the  wab^.. 

All  mimsy  were  the  borogoves, 

And  the  mome  raths  outgrabe. 

IMAGE_1  WINDOW_B  FRCH: 018  Running  F 

Bye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 

"Our  local  calls  have  us  in  hock!"  we  all  cry. 

On  Ma  Bell  why  did  you  have  to  die? 

IMAGE_1  WIND0W_C  FRCH: 019  Running  F 

Over  the  five  years  spent  on  this  project,  several  intense  week-long  design 
reviews  were  conducted,  with  the  participation  of  P.  Belmont,  B.  Brosgol, 

P.  Cohen,  R.  Dewar,  A.  Evans,  G.  Fisher,  H.  Harte,  A.L.  Hisgen,  P.  Knueven, 
M.  Kronental,  N.  Lomuto,  E.  Ploedereder,  G.  Seegmueller,  V.  Stenning,  D. 
Taffs,  and  also  F.  Belz,  R.  Converse,  K.  Correll,  A.N.  Habermann,  J. 

Sammet,  S.  Squires,  J.  Teller,  P.  Wegner,  and  P.R.  Wetheral 1 . { F10 } 

BOTTOM-OF-SCREEN 


Comments:  The  listing  of  the  "adalrm"  file  has  finished,  and  the  APSE 
command  interpreter  prompt  is  the  last  line  of  the  viewport.  Note  the  next 
page  (window  full)  of  output  is  displayed  (continuously  scrolled)  in  the 
viewport  associated  with  WINDOW_C. 

Command:  {F10}  -  Switch  the  input  context  to  the  AIM  window. 
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SET  AIM_SUSPENDS 

■ 

AIM  AIM  AIM  CLI  Running  FIO 

AIM>  ASSOC  W I NDOW_A  IMAGE_1  1  8 

AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  WINDOW_C  IMAGE_1  17  8 

AIM>  GOTO  IMAGE  IMAGE_1 
A I  M>  RESET  AIM_S'JSPENDS 
AIM>  RESET  FULL  WINDOW_B 
AIM>  SET  PADS  AIM 

* *AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM : TEST ING : AIMl . INP 
**AIM  generated  output  pad  file  name:  : USER1 : ATB : AIM :TESTING : AIM2 . OUT 
AIM>  SET  INPUT_PAD  WINDOW_A 

*  * AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM : TEST I NG : W I NDOW_A3 . INP 
AIM>  SET  OUTPUT_PAD  WINDOW_B 

*  *AIM  generated  output  pad  file  name:  :USER1  :ATB:  AIM.-TESTING:  WINDOW_A4  .  OUT 
AIM>  SET  PADS  WINDOW_C 

**AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM : TESTING : WI NDOW_C5 . I NP 

**AIM  generated  output  pad  file  name:  :USER1; ATB: AIM : TESTING :WINDOW_C6 .OUT 

AIM>  GOTO  IMAGE  IMAGE_1 

AIM>  RESET  I NPUT_PAD  WINDOW_A 

AIM>  RESET  OUTPUT  PAD  WINDOW_B 

AIM>  RESET  PADS  WINDOW_C 

AIM>  SET  FULL  WINDOW_B 

AIM>  GOTO  WINDOW  WINDOW_A 

AIM>  SET  A I M_SUSPENDS 

BOTTOM-OF-SCREEN 


Comments:  Control  returns  to  the  AIM  command  interpreter  in  the  AIM 
window. 

Command:  SET  AIM_SUSPENDS  -  Set  the  SUSPEND_ON_AIM  flag  (i.e.--set  up  the 
condition  that  if  and  when  the  SWITCH_TO_AIM  keystroke  is  entered,  ALL  APSE 
program  output  is  suspended). 
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GOTO  WINDOW_3 

AIM  ATM  AIM  CL  I  Runn  fng  AFIO 

AIM>  ASSOC  WINDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  W I NDOW_C  IMAGE_ 1  17  3 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  RESET  AIM_SUSPENDS 
AIM>  RESET  FULL  WINDOW_B 
A IM>  SET  PADS  AIM 

**AIM  generated  input  pad  file  name:  : USER1 : AT3 : AIM:TESTING : AIM1 . I NP 
**AIM  generated  output  pad  file  name:  :USER1 : ATB: AIM:TESTING: AIM2 .OUT 
AIM>  SET  INPUT_PAD  WINDOW_A 

**AIM  generated  input  pad  file  name:  : USER! : ATB : AIM: TEST iNG: WINDOW_A3 . INP 
AIM>  SET  OUTPUT_PAD  WINDOW_B 

**AIM  generated  output  pad  file  name:  : USER1 : ATB : AIM: TEST ING :WIND0W_A4 . OUT 
AIM>  SET  PADS  WINDOW_C 

*  *AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TEST ING : WINDOW_C5 .  INP 

**AIM  generated  output  pad  file  name:  : USERl : ATB : AIM : TESTING: WINDOW_C6 . OUT 

AIM>  GOTO  IMAGE  IMAGE_1 

AIM>  RESET  INPUT_PAD  WINDCW_A 

AIM>  RESET  OUTPUT_PAD  WINDCW_B 

AIM>  RESET  PADS  WINDOW_C 

AIM>  SET  FULL  WINDOW_B 

AIM>  GOTO  WINDOW  WINDOW_A 

AIM>  SET  A I M_SUSPENDS 

AIM>  GOTO  WINDOW  WINDOW_B 

BOTTCM-OF- SCREEN 


Comments:  The  AIM  window  flag  setting  has  been  changed  to  reflect  the  fact 
that  tne  SUSPEND_0N_AIM  mode  is  active. 

Command:  GOTO  WINDOW  WINDOW_B  -  Switch  the  input  context  to  WINDCW_B. 
Note  since  this  is  a  global  flag,  it  will  always  be  ON  or  OFF  for  every 
window  in  the  AIM  environment. 
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LIST  A  FILE  IN  WINDOW_B 

IMAGE_1  WINDOvTa  FRCH:017  Running  AF 

He  chortled  i  his  joy. 

’ Twas  brillig,  and  the  slithy  toves 
Did  gyre  and  gimble  in  the  vabe: 

All  mimsy  were  the  borogoves, 

And  the  mome  raths  outgrabe. 

IMAGE_i  WINDOW_B  FRCH:018  Running  AF 

3ye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 

"Our  local  calls  have  us  in  hock!"  we  all  cry. 

Oh  Ma  Bell  why  did  you  have  to  die? 

TYPE  MABELL .AIM 

IMAGE_1  WINDOW_C  FRCHj019  Running  AF 

Over  the  five  years  spent  on  this  project,  several  intense  week-long  design 
reviews  were  conducted,  with  the  participation  of  P.  Belmont,  B.  Brosgol, 

?.  Cohen,  R.  Dewar,  A.  Evans,  G.  Fisher,  H,  Harte,  A.L.  Hisgen,  P.  Knueven, 
M.  Kronental,  N.  Lomuto,  E.  Ploedereder,  G.  Seegmueller,  V.  Stenning,  D. 
Taffs,  and  also  F.  Belz,  R.  Converse,  K.  Correll,  A.N.  Habermann,  J. 

Sammet,  S.  Squires,  J.  Teller,  P.  Wegner,  and  P.R.  Wetherall. 

BOTTOM- OF - SCREEN 


Comments:  The  cursor  is  positioned  at  the  end  of  the  viewport  associated 

with  WINDOW  3. 


Command:  TYPE  MABELL. AIM  -  List  the  contents  of  "mabell"  in  WINDOW  B. 
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SWITCH  TO  AIM  WINDOW 

IMAGE_1  WINDOW_A  FRCH : 0 1 7  Running  AF 

He  chortled  in  his  joy. 

'Tvas  brillig,  and  the  slithy  toves 
Did  gyre  and  girable  in  the  vabe: 

All  mimsy  were  the  borogoves. 

And  the  mome  raths  outgrabe. 

IMAGE_1  WINDOW_B  FRCH: 018  Running  AF 

"Our  local  calls  have  us  in  hock!"  we  all  cry. 

Oh  Ma  Beil  why  did  you  have  to  die? 

TYPE  MABELL .AIM 
TYPE  MABELL. AIM 

"The  day  Bell  System  Died"  by  Lauren  Weinstein  f F 1 0 } 

IMAGE_1  WINDOW_C  FRCH: 019  Running  AF 

Over  the  five  years  spent  on  this  project,  several  intense  week-long  desicr. 
reviews  were  conducted,  with  the  participation  of  P.  Belmont,  B.  Brosgol, 

P.  Cohen,  R.  Dewar,  A.  Evans,  G.  Fisher,  H.  Harte,  A.L.  Hisgen,  P.  Knueven, 
M.  Kronental,  N.  Lomuto,  E.  Ploedereder,  G.  Seegmueller,  V.  Stenning,  D. 
Taffs,  and  also  F.  Belz,  R.  Converse,  K.  Correll,  A.N.  Habermann,  J. 

Sammet,  S.  Squires,  J.  Teller,  P.  Wegner,  and  P.R.  Wetherall. 

BOTTOM- OF -SCREEN 


Comments:  The  first  few  lines  of  "mabell"  are  listed  before  the  user 
enters  the  SWITCH_T0_AIM  keystroke  which  suspends  all  APSE  program  output. 

Command:  {F10{  -  Switch  the  input  context  to  the  AIM  window  in  order  to 
communicate  with  the  AIM  command  interpreter. 
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GOTO  WINDOW  3 


AIM  AIM  AIM  CLI  Running  AFIG 

AIM>  ASSOC  W I NDOW_C  IMAGE_I  17  8 

AIM>  RESET  A I M_SUSPENDS 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  RESET  FULL  WINDOW_B 
AIM>  SET  PADS  AIM 

*  *AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TESTING : AIM1 . INP 
**AIM  generated  output  pad  file  name:  :  'JSERl :  ATB :  AIM:  TESTING :  AIM2  .  OUT 
AIM>  SET  I NPUT_PAD  WINDOW_A 

*  * A IM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TESTING :WI NDOW_A3 . INP 
AIM>  SET  OUTPUT_PAD  WIND0W_3 

**AIM  generated  output  pad  file  name:  : USERI : ATB : AIM: TESTING : WINDOW  A4 . OUT 
AIM>  SET  PADS  WINDOW_C 

*  *AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TESTI NG : WINDOW_C5 . INP 
**AIM  generated  output  pad  file  name:  : USER1 : ATB : AIM : TEST  I NG : WI NDOW_C6 . OUT 
AIM>  GOTO  IMAGE  IMAGE  1 

AIM>  RESET  I NPUT_PAD  WINDOW_A 
AIM>  RESET  OUTPUT  PAD  WINDOW_B 
AIM>  RESET  PADS  WINDOW_C 
AIM>  SET  FULL  WINDOW_B 
AIM>  GOTO  WINDOW  WINDOW_A 
AIM>  RESET  A I M_SUSPENDS 
AIM>  GOTO  WINDOW  WINDOW_B 
AIM>  GOTO  WINDOW  WINDOW_B 

BOTTOM-OF-SCREEN 


Comments:  Note  the  AIM  window  flag  settings  do  not  change  as  a  result  of 
the  SWITCH_TO_AIM  keystroke  because  no  APSE  program  is  ever  associated  with 
the  AIM  window. 

Command:  GOTO  WINDOW  WINDOW_B  -  Switch  the  input  context  to  WINDOW  B. 
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SWITCH  TO  AIM  WINDOW 


IMAGE_1  WINDOW^ A  FRCH:017  Suspended  AFS 

He  chortled  i  his  Joy. 

'Twas  brillig,  and  the  slithy  toves 
Did  gyre  and  gimble  in  the  wabe: 

All  raimsy  were  the  borogoves, 

And  the  mome  raths  outgrabe. 

IMAGE_1  WINDOW_B  FRCH:018  Suspended  More..  AFS 

Long,  long,  time  ago, 

I  can  still  remember, 

Whem  the  local  calls  were  "free". 

And  I  knew  if  I  paid  my  bill, 

And  never  wished  them  any  ill. 

That  the  phone  company  would  let  me  be...iF10} 

IMAGE  1  WINDOW_C  FRCH:019  Suspended  AFS 

Over  tHe  five  years  spent  on  this  project,  several  intense  week-long  desicr. 
reviews  were  conducted,  with  the  participation  of  P.  Belmont,  B.  Brosgol, 

P.  Cohen,  R.  Dewar,  A.  Evans,  G.  Fisher,  H.  Harte,  A.L.  Hisgen,  P.  Knueven, 
M.  Kronental,  N.  Lomuto,  E.  Ploedereder,  G.  Seegmueller,  V.  Stenning,  D. 
Taffs,  and  also  F.  Belz,  R.  Converse,  K.  Correll,  A . N .  Habermann,  J. 

Sammet,  S.  Squires,  J.  Teller,  P.  Wegner,  and  P.R.  Wetherail. 

BOTTOM-OF -SCREEN 


Comments:  The  cursor  is  positioned  at  the  end  of  the  viewport  associated 
with  WINDOW_B.  Note  the  viewport  headers  reflect  the  new  window  flag 
settings  ("AFS"),  as  all  APSE  program  output  has  been  suspended.  However, 
all  information  that  was  queued  before  the  suspend  flag  was  set  will  be 
output,  thus  the  more  flag  is  set  and  the  queued  data  may  still  be  output. 
To  resume  the  APSE  program  output  the  user  must  use  the  RESUME 
PROGRAM_OUTPUT  command  (see  the  next  session  for  details  of  this  command). 

Command:  {F10}  -  Switch  the  input  context  to  the  AIM  window  in  order  tc 
communicate  with  the  AIM  command  interpreter. 
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AIM  AIM  AIM  CLI  Running  AFIO 

AIM>  RESET  AIM_SUSPENDS 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  RESET  FULL  WINDOW_B 
AIM>  SET  PADS  AIM 

**AIM  generated  input  pad  file  name:  : USER1 : ATB : AIM: TESTING : AIMl . INP 
* *AIM  generated  output  pad  file  name:  : USER1 : ATB : AIM: TESTING : AIM2 . OUT 
A IM>  SET  I NPUT_PAD  WINDOW_A 

*  * A I M  generated  input  pad  file  name:  : USER! : ATB : AIM : TESTING : WINDOW_A3 . INP 
A IM>  SET  OUTPUT_PAD  WINDOW_B 

* *AIM  generated  output  pad  file  name:  :USER1 : ATB: AIM: TESTING :WINDOW_A4 .OUT 
AIM>  SET  PADS  WINDOW_C 

*  *  A I M  generated  input  pad  file  name:  : USER1 : ATB : AIM : TEST  I NG : WINDOW_C5 . I NP 

* *AIM  generated  output  pad  file  name:  :USER1 : ATB: AIM: TEST ING:WINDOW_C6 .OUT 

AIM>  GOTO  IMAGE  IMAGE_1 

AIM>  RESET  INPUT_PAD  WINDOW_A 

AIM>  RESET  OUTPUT_PAD  WINDOW_B 

AIM>  RESET  PADS  WINDOW_C 

AIM>  SET  FULL  WINDOW_B 

AIM>  GOTO  WINDOW  WINDOW_A 

AIM>  SET  A I M_SUSPENDS 

AIM>  GOTO  WINDOW  WINDOW_B 

AIM>  GOTO  WINDOW  WINDOW_B 

AIM>  ABORT_AIM 

BOTTOM-OF-SCREEN 


Comments:  Control  has  returned  to  the  AIM  command  interpreter  in  the  AIM 

vindow. 

Command:  A30RT_AIM  -  Abort  this  AIM  session  <i.e. —  kill  the  APSE  LIST 

process  running  in  WIND0W_B  and  then  exit  the  AIM). 
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ABORT  MESSAGE 


AIM>  RESET  AIM_SUSPENDS 
AIM>  RESET  FULL  WINDOW_B 
AIM>  SET  PADS  AIM 

**AIM  generated  input  pad  file  name:  :USERI : ATB: AIM: TESTING : AIM! . INP 
**AIM  generated  output  pad  file  name:  :USER1 : ATB: AIM:TESTING: AIM2 .OUT 
AIM>  SET  INPUT_PAD  WINDOW_A 

**AIM  generated  input  pad  file  name:  : USER! : ATB : AIM : TEST  I NG : Wi NDOW_A3 .  IN? 
AIM>  SET  OUTPUT_PAD  WINDOW_B 

**AIM  generated  output  pad  file  name:  :USERi : ATB: AIM:TESTING:WIND0W_A4 .  OUr 
AIM>  SET  PADS  WINDOW_C 

*  *  AIM  generated  input  pad  file  name:  :USER1 : ATB: AIM: TESTING : WIND0W_C5 . INP 
**AIM  generated  output  pad  file  name:  :USER1 : ATB : AIM : TESTING :WINDOW_C 6 . OUr 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  RESET  I NPUT_PAD  WINDOW_A 
AIM>  RESET  OUTPUT_PAD  WINDOW_B 
AIM>  RESET  PADS  WINDOW_C 
AIM>  SET  FULL  WINDOW_B 
A IM>  GOTO  WINDOW  WINDOW_A 
AIM>  SET  AIM_SUSPENDS 
AIM>  GOTO  WINDOW  WIND0W_3 
AIM>  GOTO  WINDOW  WIND0W_3 
AIM>  ABORT  AIM 
-) 

BOTTOM-OF- SCREEN 


Comments:  The  AIM  command  interpreter  indicates  that  the  APSE  proce: 
executing  in  WINDOW_3  has  been  stopped,  and  then  the  AIM  terminates  i; 
execut i on . 


Command:  None. 


SESSION  4 


PAGE  TERMINAL  TUTORIAL 
WINDOW  RELATED  COMMANDS 


The  following  pad  (text)  files  were  generated  in  this  session: 

1 .  :USER1 :ATB: AIM: TESTING: AIM1 . INP 
set  input_pad  window_a 

set  output  pad  window_b 
set  pads  wTndow_c 
goto  image  image_l 
reset  input_pad  window_a 
reset  output  pad  window_b 
reset  pads  wTndow_c 
set  full  window_b 
goto  window  window_a 
set  aim_suspends 
goto  window  window_b 
goto  window  window_b 
abort_aim 

2 .  : USER1 : ATB : AIM : TEST  I NG : AIM2 . OUT 

**AIM  generated  output  pad  file  name:  :USER1 : ATB: AIM:TESTING: AIM2 .OUT 
AIM> 

**AIM  generated  input  pad  file  name:  :USER1 : ATB: AIM:TESTING:WINDOW_A3  . 
AIM> 

**AIM  generated  output  pad  file  name:  :USER1 : ATB: AIM:TESTING:WINDOW_B4 
AIM> 

**AIM  generated  input  pad  file  name:  :USER1:ATB:AIM:TESTING:WIND0W_C5. 
**AIM  generated  output  pad  file  name:  : USER1 : ATB : AIM : TEST I NG : W I NDOW_C6 
AIM> 

AIM> 

AIM> 

AIM> 

AIM> 

AIM> 

AIM> 

AIM> 

AIM> 

AIM> 

3.  WINDOW_A3. INP 
type  jab. aim 

4.  W I NDOW_  B  4 . OUT 

)  type  mabell.aim 

"The  Day  Bell  System  Died"  by  Lauren  Weinstein 

Long,  long,  time  ago, 

I  can  still  remember, 

When  the  local  calls  were  "free". 

And  I  knew  if  I  paid  my  bill, 

And  never  wished  them  any  ill, 

That  the  phone  company  would  let  me  be... 
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But  Uncle  Sam  said  he  knew  better. 

Split  'em  up,  for  all  and  ever! 

We’ll  foster  competition: 

It's  good  capital-ism! 

I  can't  remember  if  I  cried, 

When  my  phone  bill  first  tripled  in  size. 

But  something  touched  me  deep  inside, 

The  day...  Bell  System...  died. 

And  we  were  singing... 

Bye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 

"Our  local  calls  have  us  in  hock!"  we  all  cry. 

Oh  Ma  Bell  why  did  you  have  to  die? 

Ma  Bell  why  did  you  have  to  die? 

Is  your  office  Step  by  Step, 

Or  have  you  gotten  some  Crossbar  yet? 

Everybody  used  to  ask... 

Oh,  is  TSPS  coming  soon? 

IDDD  will  be  a  boon! 

And,  I  hope  to  get  a  Touch-Tone  phone,  real  soon. 

The  color  phones  are  really  neat, 

And  direct  dialing  can’t  be  beat! 

My  area  code  is  "low": 

The  prestige  way  to  go! 

Oh,  'they  just  raised  phone  booths  to  a  dime! 

Well, v I  suppose  it’s  about  time. 

I  remember  how  the  payphones  chimed. 

The  day...  Bell  System...  died. 

And  we  were  singing... 

Bye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 

"Our  local  calls  have  us  in  hock!"  we  all  cry. 

Oh  Ma  Bell  why  did  you  have  to  die? 

Ma  Bell  why  did  you  have  to  die? 

Back  then  we  were  all  at  one  rate, 

Phone  installs  didn't  cause  debate, 

About  who'd  put  which  wire  where... 

Installers  came  right  out  to  you. 

No  "phone  stores"  with  their  ballyhoo, 

And  411  was  free,  seemed  very  fair! 
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But  FCC  wanted  it  seems, 

To  let  others  skim  long-distance  creams. 

No  matter  'bout  the  locals, 

They're  mostly  all  just  yokels) 

And  so  one  day  it  came  to  pass, 

That  the  great  Bell  System  did  collapse, 

In  rubble  now,  we  all  do  mass, 

The  day...  Bell  System...  died. 

So  bye,  bye,  Ma  Bell,  why  did  you  die?  . 

We  get  static  from  Sprint  and  echo  from  MCI, 

"Our  local  calls  have  us  in  hock!"  we  all  cry. 

Oh  Ma  Bell  why  did  you  have  to  die? 

Ma  Bell  why  did  you  have  to  die? 

I  drove  on  out  to  Murray  Hill, 

To  see  Bell  Labs,  some  time  to  kill, 

But  the  sign  there  said  the  Labs  were  gone. 

I  went  back  to  my  old  CO, 

Where  I'd  had  my  phone  lines,  years  ago,  * 

But  it  was  empty,  dark,  and  ever  so  forlorn... 

No  relays  pulsed, 

No  data  crooned, 

No  MF  tones  did  play  their  tunes, 

There  wasn't  a  word  spoken, 

All  carrier  paths  were  broken... 

And  so  that's  how  it  all  occurred, 

Microwave  horns  just  nests  for  birds. 

Everything  became  so  absurd, 

The  day...  Bell  System...  died. 

So  bye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 

"Our  local  calls  have  us  in  hock!"  we  all  cry. 

Oh  Ma  Bell  why  did  you  have  to  die? 

Ma  Bell  why  did  you  have  to  die? 

We  were  singing: 

Bye,  bye,  Ma  Bell,  why  did  you  die? 

We  get  static  from  Sprint  and  echo  from  MCI, 

"Our  local  calls  have  us  in  hock!"  we  all  cry. 

Oh  Ma  Bell  why  did  you  have  to  die? 
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5.  W I NDOW_C  5 . I NP 
type  lrm.aim 

6.  WINDOW_C6 . OUT 

Foreword 


Ada  is  the  result  of  a  collective  effort  to  design  a  common  language  fc: 
programming  large  scale  and  real-time  systems. 

The  common  high  order  language  program  began  in  1974.  The  requirements  o: 
the  United  States  Department  of  Defense  were  formalized  in  a  series  o: 
documents  which  were  extensively  reviewed  by  the  Services,  industrial 
organizations,  universities,  and  foreign  military  departments.  The  Acc 
language  was  designed  in  accordance  with  the  final  (  1978)  form  of  thesr. 
requirements,  embodied  in  the  Steelman  specification. 

The  Ada  design  team  was  led  by  Jean  D.  Ichbiah  and  has  included  Berne 
Kr ieg-3rueckner ,  Brian  A.  Wichmann,  Henry  F.  Ledgard,  Jean-Claude  Heliard, 
Jean-Loup  Gailly,  Jean-Raymond  Abrial,  John  G.P.  Barnes,  Mike  Woodger, 
Olivier  Roubine,  Paul  N.  Hilfinger,  and  Robert  Firth. 

At  various  stages  of  the  project,  several  people  closely  associated  with 
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A. 5  SESSION  5  -  APSE  PROGRAM  RELATED  COMMANDS 


This  session  demonstrates  the  use  of  the  SUSPEND,  RESUME,  and 
TERMINATE  commands.  The  following  text  files  are  used  in  this 
session: 

1.  demol.aim 


CREATE 

IMAGE 

IMAGE  1 

CREATE 

IMAGE 

IMAGE  2 

CREATE 

WINDOW 

WINDOW 

A 

CREATE 

WINDOW 

WINDOW 

B 

CREATE 

WINDOW 

WINDOW 

C 

CREATE 

WINDOW 

WINDOW 

D 

ASSOC 

WINDOW  A 

IMAGE 

1 

1 

8 

ASSOC 

WINDOW  B 

IMAGE 

1 

9 

8 

ASSOC 

WINDOW  C 

IMAGE 

1 

17 

8 

ASSOC 

WINDOW  C 

IMAGE 

2 

1 

12 

ASSOC 

WINDOW  D 

IMAGE 

2 

13 

12 

2.  demoI5.aim 

SCRIPT  demol.aim 
SCRIPT  demol6 . aim 

3.  demolb.aim 

GOTO  WINDOW  WINDOW_A 
SUSPEND  EXECUTION  WINDOW_A 
SUSPEND  PROGRAMJDUTPUT  WINDOW_C 
GOTO  IMAGE  IMAGE_1 
INFO  IMAGE  IMAGE_1 
RESUME  EXECUTION  WINDOW_A 
RESUME  PROGRAM_OUTPUT  WINDOW_C 
GOTO  IMAGE  IMAGE_1 
ABORT 

4.  your_f i le . a  im 

This  file  contains  information  concerning  the  eventual  destruction 
and  subsequent  desolation  of  the  world.  The  information  contained 
herein  is  not  of  a  secret  matter  but  possibly  could  alarm  the 
general  population.  I  ask  only  that  those  who  are  exposed  to  this 
material  use  good  judgement  and  be  very  cautious  when  discussing 
the  contents  with  other  people.  For  those  who  may  be  offended  by 
all  or  part  of  the  information  contained  herein,  I  offer  my 
sincere  apologies.  This  paper  started  as  my  personal  thoughts  on 
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INVOKE  AIM  FROM  APSE 

-)  AIM 


BOTTOM-OF-SCREEN 


Comments: 

Command:  AIM  -  Invoke  the  AIM  from  the  APSE. 
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MAIN  MAIN 

AOS/VS  CLI  REV  05.01.00.00 


SWITCH  TO  AIM  IMAGE 
FRCH : 0 1 6  Running 

9-APR-85  13:26:43  { F10 } 


AF 


BOTTOM-OF-SCREEN 


Comments:  The  AIM  initializes  the  current  image  to  be  MAIN.  To  enter  AIM 
textual  commands,  the  user  must  communicate  through  the  AIM  window  to  the 
AIM  command  interpreter. 

Command:  { F 1 0 }  -  Set  the  current  image  to  be  the  AIM  image. 
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INVOKE  SCRIPT 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  SCRIPT  "demol5.aim" 


BOTTOM-OF-SCREEN 


Comments:  The  cursor  is  now  at  the  top  of  the  AIM  image.  AIM  commands  c 

only  be  entered  in  the  AIM  image.  Control  has  been  passed  to  the  AIM 
executing  in  the  AIM  window. 


Command:  SCRIPT  "demol5.aim" 


Demol5  is  a  system  dependent  name. 


t 
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ECHO  SCRIPT  INPUT 


AIM 

AIM  AIM  CLI 

Running 

AIM> 

SCRIPT 

"demol5.aim" 

AIM> 

SCRIPT 

"demol .aim" 

AIM> 

CREATE 

IMAGE  IMAGE  1 

AIM> 

CREATE 

IMAGE  IMAGE  2 

AIM> 

CREATE 

WINDOW  WINDOW 

A 

AIM> 

CREATE 

WINDOW  WINDOW 

B 

AIM> 

CREATE 

WINDOW  WINDOW 

C 

AIM> 

CREATE 

WINDOW  WINDOW- 

D 

8  IM> 

ASSOC 

WINDOW  A  IMAGE 

1 

1 

8 

AIM> 

ASSOC 

WINDOW~B  IMAGE 

1 

9 

8 

AIM> 

ASSOC 

WINDOW  C  IMAGE 

1 

17 

8 

AIM> 

ASSOC 

WINDOW  C  IMAGE 

2 

1 

12 

a:m> 

ASSOC 

WINDOW  D  IMAGE_ 

2 

13 

12 

AIM> 

SCRIPT 

"demol?. aim" 

AIM> 

GOTO  WINDOW  W I NDOW_A 

BOTTOM-OF- SCREEN 


Comments:  This  session  starts  with  the  invocation  of  a  script,  demol5. 
Script  demolS  invokes  demol.  Demol  creates  some- windows  and  images  and 
associates  them.  DemolS  then  invokes  another  script,  demol6,  to 
demonstrate  the  commands  explained  in  this  session. 

Command:  GOTO  WINDOW  WINDOW_A  -  This  command  is  part  of  the  script.  The 
GOTO  stops  the  script  and  puts  the  user  in  interactive  mode  in  WIND0W_A. 
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INVOKE  A  PROGRAM 


IMAGE- 

_1 

WINDOW_A 

FRCH : 0 1 7 

Runn ing 

AOS/VS 

CLI 

REV  05.01.00.00 

1 1 -APR-85 

8:55:29  ENTER/NO_NEWS 

IMAGE_ 

l 

WINDCW_3 

FRCH: 013 

Running 

AOS/VS 

CLI 

REV  05.01.00.00 

ll-APR-85 

8:55:29 

IMAGE- 

-1 

W I NDOW_C 

FRCH: 019 

Running 

AOS/VS 

CLI 

REV  05.01.00.00 

ll-APR-85 

8:55:29 

BOTTCM-OF- SCREEN 


Comments:  Demol  completes  execution  and  demo 16  starts.  Demol6  contains 

GOTO  which  sends  the  cursor  to  one  of  the  windows  created  in  demol. 

Command:  ENTER/NO_NEWS  -  enter  the  ADE  to  compile  a  program 


A- 1 1 2 
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INVOKE  A  PROGRAM 

IMAGE_1  WINDOvTa  FRCH: 017  Running  AF 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29  ENTER/NO  NEWS 

)  ENTER/NC_NEWS  ~~ 

DATA  GENERAL/RCLM  Ada  Development  Environment  Revision  2.20.00.00 
ADE  Directory  is  :USER1:ADE 


Current  di 
IMAGE_i 

rectory  is  :USER1: 
WINDOW  B 

AT3 : AIM  DIR  REHOS 
FRCH: 018 

T : TESTING 

Runn i ng 

AF 

AOS /vs  CLI 

REV  05.01.00.30 

ll-APR-85 

8:55:29 

I MAGE_1 

w I NDOW_C 

FRCH: 019 

Running 

AF 

AOS/VS  CLI 

REV  05.01.00.00 

ll-APR-85 

8:55:29 

30TT0M-0F- SCREEN 


Comments:  The  ENTER  command  is  used  to  enter  the  ADE.  The  ADE  was  entered 

two  directory  levels  above  the  source  code  to  be  compiled. 


Command:  DIR  REHOST: TESTING  -  reset  the  directory 
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INVOKE  A  PROGRAM 


IMAGE_1  WINDOW_A  FRCH:017  Running  AF 

)  ENTER/ NO_NEWS 

DATA  GENERAL/ROLM  Ada  Development  Environment  Revision  2.20.00.0C 


ADE  Directory  is  :USER1:ADE 

Current  directory  is  :USER1:ATB:AIM  DIR  REHOST: TESTING 
-  DIR  REHOST: TESTING  BATCH  ADA/MAIN  PROGRAM  TEST 


IMAGE_1 

WINDOW_B 

FRCH : 0 18 

Running 

AOS/VS  CL I 

REV  05.01.00.00 

ll-APR-85 

8:55:29 

IMAGE_1 

WINDCW_C 

FRCH: 019 

Running 

AOS/VS  CL  I 

REV  05.01.00.00 

li-APR-85 

8:55:29 

AF 


AF 


BOTTOM-OF-SCREEN 


Comments:  The  directory  command  is  used  to  return  to  the  source  code  to  be 

compiled. 

Command:  BATCH  ADA/MAIN_PROGRAM  TEST  -  Execute  the  Ada  compiler. 
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INVOKE  A  PROGRAM 


IMAGE_1  W I NDOW_A  FRCH:017  Running  AF 

ADE  Directory  is  :USER1:ADE 

Current  directory  is  : USER1 : ATB : AIM  DIR  REHOST: TESTING 

-  DIR  REHOST: TESTING  BATCH  ADA/MA I N_PROGRAM  TEST 

-  BATCH  ADA/MA I N_PROGRAM  TEST 
DELETED  : udd : FRCH: batch : batch  out 


QUEUED,  SEQ 

:mage_i 

18533,  QPRI =127 

W I NDOW_B 

{ F5 } 

FRCH : 0 1 8 

Runn i ng 

AF 

AOS/VS  CLI 

REV  05.01.00.00 

x 1 -APR-85 

8:55:29 

:mage_i 

W I NDOW_C 

FRCH: 019 

Running 

AF 

AOS/VS  CLI 

REV  05.01.00.00 

1 1 -APR-8  5 

8:55:29 

BOTTOM-OF-SCREEN 


Comments:  The  Ada  compiler  is  started. 

Command:  { F  5 } 
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EXECUTE  ANOTHER  PROGRAM 


IMAGE_1  W I NDOW_A  FRCH:017  Running  AF 

ADE  Directory  is  :USER1:ADE 

Current  directory  is  : USER1 : ATB : AIM  DIR  REHOST: TESTING 

-  DIR  REHOST: TESTING  BATCH  ADA/MA I N_PROGRAM  TEST 

-  BATCH  ADA/MA I N_PROGRAM  TEST 
DELETED  : udd : FRCH : batch: batch  out 


QUEUED,  SEQ 
IMAGE_1 

18533,  QPRI =127 
WINDOW_B 

FRCH: 018 

Running 

AF 

AOS/VS  CL I 

REV  05.01.00.00 

ll-APR-85 

8:55:29  ENTER/NO_NEWS 

IMAGE_1 

W I NDOW_C 

FRCH: 019 

Runn i ng 

AF 

AOS /VS  CL  I 

REV  05.01.00.00 

ll-APR-85 

8:55:29 

BOTTOM-OF-SCREEN 


Comments:  The  cursor  has  now  moved  to  the  next  viewport  using  the  defaul 

binding  for  the  NEXT_VIEWPORT  keystroke. 

Command:  ENTER/NO_NEWS  -  Enter  the  ADE  two  levels  up  again  program. 
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EXECUTE  ANOTHER  PROGRAM 


IMAGE_1  WINDOW_A  FRCH:017  Running  AF 

ADE  Directory  is  :USER1:ADE 

Current  directory  is  :USER1 : ATB: AIM  DIR  REHOST; TESTING 

-  DIR  REHOST '.TESTING  BATCH  ADA/MA I  N_PROGRAM  TEST 

-  BATCH  ADA/MA I N_PROGRAM  TEST 
DELETED  ; udd : FRCH : batch : batch  out 


QUEUED,  SEQ 

18533,  QPRI =127 

IMAGE  1 

WINDOW  B 

FRCH: 018 

Running 

AOS/VS  CLI 

REV  05.01.00.00 

ll-APR-85 

8:55:29  ENTER/ NO_NEWS 

)  ENTER/NO 

NEWS  ~~ 

DATA  GENERAL/ROLM  Ada  Development  Environment  Revision  2.20.00.00 
ADE  Directory  is  :USER1:ADE 

Current  directory  is  : USER1 : ATB : AIM  DIR  REHOST: TESTING 
IMAGE_1  W I NDOW_C  FRCH: 019  Running  AF 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-35  8:55:29 


_ BOTTOM-OF-SCREEN _ 

Comments:  The  ENTER  command  must  be  issued  for  each  window. 

Command:  DIR  REHOST: TESTING  -  again,  reset  the  directory  program. 
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EXECUTE  ANOTHER  PROGRAM 

IMAGE_1  WINDOW^ A  FRCH : 0 1 7  Running  AF 

ADE  Directory  is  :USER1:ADE 

Current  directory  is  :  USER1 :  ATB :  AIM  DIR  REHOST '.TESTING 

-  DIR  REHOST: TESTING  BATCH  ADA/MA I N_PROGRAM  TEST 

-  BATCH  ADA/MAI N_PROGRAM  TEST 
DELETED  :udd: FRCH : batch : batch_out 
QUEUED,  SEQ  18533,  QPRI=127 

IMAGE_1  W I NDOW_B  FRCH: 018  Running  AF 

)  ENTER/NO_NEWS  ^ 

DATA  GENERAL/ROLM  Ada  Development  Environment  Revision  2.20.00.00 
ADE  Directory  is  :USER1:ADE 

Current  directory  is  : USER1 : ATB : AIM  DIR  REHOST : TESTING 

-  DIR  REHOST: TESTING  BATCH  ADALINK/MAIN_PROGRAM  TEST 

IMAGE_1  WINDOW_C  FRCH: 019  Running  AF 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29 


BOTTOM-OF-SCREEN 


Comments:  Return  to  the  directory  of  the  compiled  source  to  link  it. 

Command:  BATCH  ADALINK/MAIN  PROGRAM  TEST  -  Execute  the  Linker  program. 
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EXECUTE  ANOTHER  PROGRAM 

IMAGE_1  WINDOW_A  FRCH: 017  Running  AF- 

ADE  Directory  is  :USER1:ADE 

Current  directory  is  : USER1 : ATB : AIM  DIR  REHOST: TESTING 

-  DIR  REHOST  .-TESTING  BATCH  ADA/MA I  N_PROGRAM  TEST 

-  BATCH  ADA/MA I N_PROGRAM  TEST 
DELETED  : udd : FRCH : batch : batch_out 
QUEUED,  SEQ  18533,  QPRI=127 

IMAGE_1  WINDOW_B  FRCH: 018  Running  AF 

ADE  Directory  is  :USER1:ADE 

Current  directory  is  : USER1 : ATB : AIM  DIR  REHOST : TESTING 

-  DIR  REHOST: TESTING  BATCH  ADAL I NK/MA I N_PROGRAM  TEST 

-  BATCH  ADAL I NK/MA I N_PROGRAM  TEST 
DELETED  : udd : FRCH : batch : batch_out 
QUEUED,  SEQ=18537 ,  QPRI-127  {F5} 

IMAGE_1  W I NDOW_C  FRCH: 019  Running  AF 

AOS/VS  CLI  REV  05.01.00.00  li-APR-85  8:55:29 


BOTTOM-OF-SCREEN 


Comments:  The  cursor  has  now  moved  to  the  next  viewport  using  the  default 

binding  for  the  NEXT_V I EWPORT  keystroke. 

Command:  BATCH  ADALINK/MAIN_PROGRAM  TEST  -  Execute  the  Linker  program. 
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EXECUTE  A  THIRD  PROGRAM 


IMAGE_1  WINDOW_A  FRCH:017  Running  AF 

ADS  Directory  is  :USER1:ADE 

Current  directory  is  : USER1 : ATB : AIM  DIR  REHOST: TESTING 

-  DIR  REHOST: TESTING  BATCH  ADA/MAI N_?ROGRAM  TEST 

-  BATCH  ADA/MA I N_PROGRAM  TEST 
DELETED  : udd : FRCH : batch : bat ch_out 
QUEUED,  SEQ  18533,  QPRI=127 

IMAGE_1  WINDOW_B  FRCH: 018  .  Running  AF 

# 

ADE  Directory  is  :USERj : ADE 

Current  directory  is  :LSER1 : ATB : AIM  DIR  REHOST : TESTING 

-  DIR  REHOST: TESTING  BATCH  ADAL I NK/MA I N_PROGRAM  TEST 

-  BATCH  ADAL I NK/MA I N_PROGRAM  TEST 
DELETED  : udd : FRCH: batch: bat ch_out 
QUEUED,  SEQ=18537 ,  QPRI=127 

IMAGE_1  W I NDOW_C  FRCH: 019  Running  AF 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29  TYPE  YOUR  FILE. AIM 


BOTTOM-OF-SCREEN 


Comments:  The  cursor  has  moved  to  the  last  window  on  the  image.  The 
compiler  and  linker  are  both  running.  (It  is  assumed  that  the  programs 
being  compiled  and  linked  require  a  sufficient  amount  of  time  to  present 
these  examples . ) 


Command:  TYPE  YOUR  FILE. AIM 
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SWITCH  BACK  TO  AIM  IMAGE 

IMAGE  1  WINDOW_A  FRCH: 317  Running  AF 

ADE  Directory  is  :USER1:ADE 

Current  directory  is  : USER1 : ATB : AIM  DIR  REHOST: TESTING 

-  DIR  REHOST: TESTING  BATCH  ADA/MAI N_?ROGRAM  TEST 

-  BATCH  ADA/MA I N_PROGRAM  TEST 
DELETED  : udd : FRCH : bat ch : batch_out 
QUEUED,  SEQ  18533,  QPRI=127 

IMAGE_1  WINDOW_B  FRCH: 018  Running  AF 

ADE  Directory  is  :USER1:ADE 

Current  directory  is  : USER1 : ATB : AIM  DIR  REHCST: TESTING 

-  DIR  REHOST: TESTING  BATCH  ADAL I NK/MA I N_PROGRAM  TEST 

-  BATCH  ADAL I NK/MA I N_PROGRAM  TEST 
DELETED  : udd : FRCH : batch: bate h_out 
QUEUED,  SEQ= 18 5 3 7 ,  QPRI  =  127 

IMAGE_1  WINDOW_C  FRCH: 019  Running  AF 

AOS/VS  CLI  REV  05.01.00.00  ll-APR-85  8:55:29  TYPE  YOUR_FILE. AIM 

{ F10 } 


BOTTOM-OF-SCREEN 


Comments:  Now  start  a  third  program.  The  List  program  is  executed  to  list 

a  file  which  contains  text  for  this  demonstration. 

Command:  { F 1 0 }  -  SWITCH_TO_AIM  default  keystroke.  Return  to  AIM  image 

using  the  default  binding  for  the  SWITCH_TO_AIM  keystroke. 
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SUSPENDING  PROGRAM  OUTPUT  AND  EXECUTION 


AIM 

AIM  AIM  CLI 

Runn i ng 

AIM> 

SCRIPT 

"deno!5 . aim" 

AIM> 

SCR  I PT 

"demol . aim" 

AIM> 

CREATE 

IMAGE  IMAGE  1 

AIM> 

CREATE 

IMAGE  IMAGE  2 

AIM> 

CREATE 

WINDOW  WINDOW  A 

AIM> 

CREATE 

WINDOW  WINDOW  B 

AIM> 

CREATE 

WINDOW  WINDOW  C 

AIM> 

CREATE 

WINDOW  WINDOW  D 

AIM> 

ASSOC 

WINDOW  A  IMAGE  1 

1 

8 

AIM> 

ASSOC 

WINDOW  B  IMAGE  1 

9 

8 

AIM> 

ASSOC 

WINDOW  C  IMAGE  1 

17 

8 

AIM> 

ASSOC 

WINDOW  C  IMAGE  2 

1 

12 

AIM> 

ASSOC 

WINDOW_D  IMAGE_2 

13 

12 

AIM> 

SCRIPT 

"demo!6.aim" 

AIM> 

GOTO  WINDOW  WINDOW  A 

AIM> 

SUSPEND  EXECUTION  WINDOW  A 

AIM> 

SUSPEND  PROGRAM  OUTPUT 

WINDOW  C 

AIM> 

GOTO 

IMAGE  IMAGE  1 

BOTTOM-OF-SCREEN 


Comments:  Three  programs  have  been  started;  one  for  each  window 

IMAGE_1.  When  switched  back  to  the  AIM  image,  the  script  resumes. 

Command:  GOTO  IMAGE  IMAGE_1  -  This  command  is  a  part  of  the  script. 
GOTO  puts  the  cursor  back  IMAGE  1. 
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IMAGE  1 


CHECK  RESULTS  OF  SUSPEND  COMMANDS 


WINDOW 


FRCH  :-2 


Suspended 


ADE  Directory  is  :USER1:ADE 

Current  directory  is  :USER1 : ATB: AIM  DIR  REHOST: TESTING 

-  DIR  REHOST: TESTING  BATCH  ADA/MAI N_PROGRAM  TEST 

-  BATCH  ADA/MA I N_PROGRAM  TEST 
DELETED  : udd : FRCH : batch : bate h_out 
QUEUED,  SEQ  18533,  QPRI=127 

IMAGE  1  WINDOW_B  FRCH: 018  Suspended  AFS 


ADE  Directory  is  :USER1:ADE 

Current  directory  is  :USER1 :  ATB:  AIM  DIR  REHOST -.TESTING 

-  DIR  REHOST: TESTING  BATCH  ADAL I NK/MA I N_PROGRAM  TEST 

-  BATCH  ADAL I NK/MA I N_PROGRAM  TEST 
DELETED  : udd : FRCH : batch : batch_out 
QUEUED,  SEQ=18537,  QPRI=127 

IMAGE_1  WINDOW_C  FRCH: 019  Suspended  AFS 

subsequent  desolation  of  the  world.  The  information  contained  herein  is  not 
of  a  secret  matter  but  possibly  could  alarm  the  general  population.  I  ask 
only  that  those  who  are  exposed  to  this  material  use  good  judgement  and  be 
very  cautious  when  discussing  the  contents  with  other  people.  For  those 
who  may  be  offended  by  all  or  part  of  the  information  contained  herein,  I 
offer  my  sincere  apologies.  This  paper  started  as  my  personal  thoughts  on 
{ F10 } 

BOTTOM-OF-SCREEN  _ 


Comments:  The  script  contains  commands  to  suspend  execution  and  window 

output  and  a  GOTO.  The  GOTO  puts  the  cursor  back  to  IMAGE_1  so  the  results 
of  the  suspend  commands  can  be  seen.  Note  that  the  program  in  WIND0W_A  has 
been  suspended.  The  user  can  see  that  the  header  contains  "Suspended" 
instead  of  "Running"  indicating  that  window  output  has  been  suspended. 

ft 

Command:  {F10}  -  Switch  back  to  AIM  image.  Enter  the  SWITCH_T0_AIM 

keystroke  again. 
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MORE  INFO 

ATM  AIM  AIM  CLI  Running  Mo 


AIM> 

SCRIPT 

"demol . aim" 

AIM> 

CREATE 

IMAGE 

IMAGE  1 

AIM> 

CREATE 

IMAGE 

IMAGE  2 

AIM> 

CREATE 

WINDOW 

WINDOW 

A 

AIM> 

CREATE 

WINDOW 

WINDOW 

B 

AIM> 

CREATE 

WINDOW 

WINDOW 

C 

AIM> 

CREATE 

WINDOW 

WINDOW 

D 

AIM> 

ASSOC 

WINDOW  A 

IMAGE' 

1 

1 

8 

AIM> 

ASSOC 

WINDOW  3 

IMAGE 

1 

9 

3 

AIM> 

ASSOC 

WINDOW  C 

IMAGE 

1 

17 

8 

AIM> 

ASSOC 

WINDOW~C 

IMAGE 

2 

1 

12 

AIM> 

ASSOC 

WINDOW  D 

IMAGE- 

2 

13 

12 

AIM> 

SCRIPT 

ndemol£ . < 

a  im" 

AIM>  GOTO  WINDOW  WINDOW  A 
AIM>  SUSPEND  EXECUTION  WINDOW_A 
AIM>  SUSPEND  PROGRAM_OUTPUT  WINDCW_C 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  INFO  IMAGE  IMAGE_1 

Image  Name:  IMAGE_1 

Window  Associations: 

Window  Name  Top  Line  Viewport  Length{F4} 

BOTTOM-OF-SCREEN 


Comments:  More  flag  set 

Command:  {F4}  -  next  page  keystroke 
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EXIT  FIRST  LEVEL  OF  INFO 


AIM 

AIM 

AIM  CLI 

AIM> 

CREATE 

W I NDOW 

WINDOW  C 

AIM> 

CREATE 

WINDOW 

WINDOW  D 

AIM> 

ASSOC 

WINDOW  A 

IMAGE  1 

1 

8 

AIM> 

ASSOC 

WINDOW  B 

IMAGE  1 

9 

8 

AIM> 

ASSOC 

WINDOW  C 

IMAGE  1 

17 

8 

AIM> 

ASSOC 

WINDOW  C 

IMAGE  2 

1 

12 

AIM> 

ASSOC 

WINDOW  D 

IMAGE  2 

13 

12 

AIM> 

SCRIPT 

"demo!6  .aim’’ 

Runn  1  ng 


AF 


AIM>  GOTO  WINDOW  WINDOW_A 
AIM>  SUSPEND  EXECUTION  WINDOW_A 
AIM>  SUSPEND  PROGRAM_OUTPUT  WINDOW_C 
A IM>  GOTO  IMAGE  IMAGE_1 
A*M>  INFO  IMAGE  IMAGE  1 


Image  Name:  IMAGE_1 

Window  Associations: 

Window  Name  Top  Line 

WINDOW_A  1 

WINDOW_B  9 

WINDOW_C  17 

INFO  Image  Name?  {return} 


Viewport  Length 
8 
8 
8 


BOTTOM-OF-SCREEN 


Comments:  The  script  contains  an  INFO  command  to  allow  another  way  of 

checking  the  status  of  the  programs  running  in  the  windows  of  IMAGE_1. 

Command:  {return}  -  Enter  a  carriage  return  to  exit  the  current  level  of 

the  INFO  utility. 
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EXIT  INFO 

AIM  aTm  AIM  CLI  Running  AF 

AIM>  CREATE  WINDOW  WINDOW_D 

AIM>  ASSOC  W I NDCW_A  IMAGE_1  1  8 

AIM>  ASSOC  W I NDOW_B  IMAGE_1  9  8 

AIM>  ASSOC  W I NDOW_C  IMAGE_1  17  8 

AIM>  ASSOC  WINDCW_C  IMAGE_2  1  12 

AIM>  ASSOC  WINDOW  D  IMAGE_2  13  12 

AIM>  SCRIPT  "demolS.aim" 

AIM>  GOTO  WINDOW  WINDOW_A 
AIM>  SUSPEND  EXECUTION  WINDOW_A 
AIM>  SUSPEND  PROGRAM  OUTPUT  WINDOW  C 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  INFO  IMAGE  IMAGE_1 

Image  Name:  IMAGE_1 

Window  Associations: 

Window  Name  Top  Line 

W I NDOW_A  1 

WINDCW_B  9 

W I NDOW_C  17 

INFO  Image  Name? 

INFO  Object?  {return} 

BOTTOM-OF -SCREEN 


Comments:  Entering  a  carriage  return  exits  the  current  level  of  INF 

command. 

Command:  {return}  -  Enter  a  second  carriage  return  to  exit  INFO. 


Viewport  Length 
8 
8 
8 
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SCRIPT  RESUMES  AFTER  EXITING  INFO 

AIM  AIM  AIM  CLI  Running  AF 

AIM>  ASSOC  WINDOW_C  IMAGE_2  1  12 

AIM>  ASSOC  WINDOW_D  IMAGE_2  13  12 
AIM>  SCRIPT  "demol6 .aim" 

AIM>  GOTO  WINDOW  WINDOW_A 
AIM>  SUSPEND  EXECUTION  WINDOW_A 
AIM>  SUSPEND  PROGRAM_OUTPUT  WINDOW_C 
A I M>  GOTO  IMAGE  IMAGE_1 
A IM>  INFO  IMAGE  IMAGE_1 

Image  Name:  IMAGE_1 

Window  Associations: 

Window  Name  Top  Line  Viewport  Length 

W I NDOW_A  1  8 

WIND0W_3  9  8 

WINDOW_C  17  8 

INFO  Image  Name? 

INFO  Object? 

AIM>  RESUME  EXECUTION  WINDOW_A 
AIM>  RESUME  PROGRAM_OUTPUT  WINDOW_C 
A IM>  GOTO  IMAGE  IMAGE_1 

BOTTOM-OF-SCREEN 


Comments:  Exit  the  last  level  of  INFO  to  restart  the  script. 

Command:  GOTO  IMAGE  IMAGE_1  -  This  command  is  contained  in  the  script. 

The  GOTO  puts  the  cursor  once  again  to  IMAGE_1. 
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CHECK  STATUS  OF  WINDOWS 


IMAGE_1  W I NDOW_ A  FRCH:017  Running  AF 

ADE  Directory  is  :USER1:ADE 

Current  directory  is  : USER1 : ATB : AIM  DIR  REHOST: TESTING 

-  DIR  REHOST: TESTING  BATCH  ADA /MA I N_ PROGRAM  TEST 

-  BATCH  ADA/MAIN_PROGRAM  TEST 
DELETED  : udd : FRCH ; ba  t  c h : ba  t  c  h_ou  t 
QUEUED,  SEQ  18533,  QPRI=127 

IMAGE_1  WINDOW_B  FRCH:018  Running  AF 

ADE  Directory  is  :USER1:ADE 

Current  directory  is  : USER1 : ATB : AIM  DIR  REHOST: TESTING 

-  DIR  REHCST: TESTING  BATCH  ADAL I NK/MA I N_PROGRAM  TEST 

-  BATCH  ADAL INK/MAI N_PROGRAM  TEST 
DELETED  : udd : FRCH : batch : batch_out 
QUEUED,  SEQ= 1853 7 ,  QPRI  =  127 

IMAGE_1  W I NDOW_C  FRCH: 019  Running  AF 

subsequent  desolation  of  the  world.  The  information  contained  herein  is  nc* 
of  a  secret  matter  but  possibly  could  alarm  the  general  population.  I  ask 
only  that  those  who  are  exposed  to  this  material  use  good  judgement  and  be 
very  cautious  when  discussing  the  contents  with  other  people.  For  those 
who  may  be  offended  by  all  or  part  of  the  information  contained  herein,  I 
offer  my  sincere  apologies.  This  paper  started  as  my  personal  thoughts  on 
{FIG} 

BOTTOM-OF- SCREEN 


Comments:  The  script  resumes  execution  when  the  info  utility  is  exited. 
The  script  contains  the  RESUME  commands  and  also  a  TERMINATE  command.  The 
last  line  of  the  script  is  a  GOTO  command.  Go  back  to  the  image  and  check 
the  results  of  these  commands.  Note  that  the  program  in  WIND0W_A  is  nc 
longer  suspended  and  has  now  completed.  (The  TERMINATE  command  has  r.ct 
been  fully  implemented.) 

Command:  { F 1 0 }  -  Switch  to  AIM  image  and  exit. 
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A30RT 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  ASSOC  W I NDOW_C  IMAGE_2  1  12 

AIM>  ASSOC  WINDOW_D  IMAGE_2  13  12 

AIM>  SCRIPT  "demolb . aim" 

AIM>  GOTO  WINDOW  WINDOW_A 
AIM>  SUSPEND  EXECUTION  WINDOW_A 
AIM>  SUSPEND  PROGRAM_OUTPUT  WINDOV_C 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  INFO  IMAGE  IMAGE  1 


Image  Name:  IMAGE_1 


Window  Associations 
Window  Name 
W I NDOW_A 
WINDOW  B 
WINDOW  C 


Top  Line 
1 
9 

17 


Viewport  Length 
8 
8 
8 


INFO  Image  Name? 

INFO  Object? 

AIM>  RESUME  EXECUTION  WINDOW_A 
AIM>  RESUME  ?ROGRAM_OUTPUT  WINDOW_C 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  ABORT_ A I M 

BOTTOM -OF- SCREEN 


Comments:  Go  back  to  the  AIM  image  to  exit. 

Command:  A30RT_AIM  -  This  command  is  contained  in  the  script.  Abort 

AIM  and  all  sub-processes. 


the 
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ABORT 


AIM>  ASSOC  WINDOW_C  IMAGE_2  1  12 

AIM>  ASSOC  WINDOW_D  IMAGE_2  13  12 

AIM>  SCRIPT  "demol6 .aim" 

AIM>  GOTO  WINDOW  WINDOW_A 
AIM>  SUSPEND  EXECUTION  WINDOW_A 
AIM>  SUSPEND  PROGRAM_OUTPUT  WINDOW_C 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  INFO  IMAGE  IMAGE  1 


Image  Name:  IMAGE_1 


Window  Assoc iat ions : 


Window  Name 
WINDOW_A 
WINDOW_B 
WINDOW  C 


Top  Line 
1 
9 

17 


Viewport  Length 
8 
8 
8 


INFO  Image  Name? 

INFO  Object? 

AIM>  RESUME  EXECUTION  WINDOWA 
AIM>  RESUME  PROGRAM_OUTPUT  WINDCW_C 
AIM>  GOTO  IMAGE  IMAGE_1 
AIM>  ABORT  AIM 
-) 

BOTTCM-OF -SCREEN 


Comments:  The  ABORT  command  terminates  all  active  programs.  The 

running  in  WiNDOW_C  is  aborted. 


prog 
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A. 6  SESSION  6  -  AIM  HELP  UTILITY 


The  AIM  Help  Utility  session  explains  the  use  of  the  HELP 
The  Help  Utility  presents  information  on  the  AIM  commands 
associated  parameters.  The  following  text  files  are  used 
sess  ion : 


command . 
and  their 
i  n  this 


None . 
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INVOKE  AIM  FROM  APSE 

-)  AIM 


BOTTOM-CF-SCREEN 


Comments : 

Command:  AIM  -  invoke  the  AIM  from  the  APSE. 


A-  1  3  2 
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SWITCH  TO  AIM  IMAGE 

MAIN  MAIN  FRCH: 016  "Running  AF 

AOS/VS  CL I  REV  05.01.00.00  9- APR- 8 5  13:26:43  {FIG} 


BOTTOM-OF- SCREEN 


Comments:  The  AIM  initializes  the  current  image  to  be  MA.IN.  To  enter  AIM 
textual  commands  the  user  must  communicate  through  the  AIM  image  to  the  AIM 
command  interpreter. 

Command:  { F 1 0 }  -  Set  the  current  image  to  be  the  AIM  image. 
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INVOKE  DEMO I. AIM  SCRIPT 


AIM  AIM  AIM  CLI  Running  AF 

AIM>  HELP 


_ BOTTOM-OF-SCREEN_ 

Comments:  The  AIM  image  is  initially  blank. 

Command:  HELP  -  invoke  AIM  HELP  utility. 
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THE  AIM  HELP  UTILITY 

AIM  AIM  AIM  CLI  Running  AF 

AIM>  HELP 

Initializing  Help... 

Information  Available: 


ABORT_AIM 

ASSOCIATE 

CREATE 

DEFINE 

DELETE 

DISASSOCIATE 

EXIT 

GOTO 

HELP 


INFO 

KEYSTROKES 

RESET 

RESUME 

SCRIPT 

SET 

SUSPEND 

TERMINATE  EXECUTION 


Topic?  A 


BOTTOM-OF-SCREEN 


Comments:  The  HELP  utility  lists  ALL  the  AIM  topics  for  which  help  is 
available.  When  HELP  prompts  for  a  topic  name,  key  in  one  of  the  AIM 
keywords  from  the  list. 

Command:  A  -  request  HELP  information  on  ALL  AIM  commands  (textual  or 
keystroke)  that  start  with  the  single  character  'A' . 
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MATCH  THE  ’A'  ABBREVIATION 


AIM  AIM  AIM  CLI  Running  More..  AF 

Initializing  Help... 

Information  Available: 

ABORT_AIM 
ASSOCIATE 
CREATE 
DEFINE 
DELETE 

DISASSOCIATE 
EXIT 
GOTO 
HELP 

Topic?  A 
ABORT_AIM 

The  ABORT_AIM  command  terminates  all  processes  running  under  the  AIM 
and  exits  from  the  AIM  program.  All  active  subordinate  processes  are 
terminated  without  warning. 

Additional  Information  Available:  f F4 } 

BOTTOM-OF-SCREEN 


INFO 

KEYSTROKES 

RESET 

RESUME 

SCRIPT 

SET 

SUSPEND 

TERMINATE  EXECUTION 


Comments : 
correspond! 
alphabet ica 
screenf ull , 


Three  AIM  commands  were  recognized  from  the 
ng  top  level  HELP  text  for  each  command 
lly  by  topic  name.  The  HELP  text  did  NOT  all  f 
so  the  "More.."  indicator  is  turned  on  in  the  viewpo 


'A 

is 

it 

rt 


The 
printed 
in  one 
header . 


Command:  { F4 } 


display  next  page  of 


window's  output. 
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REMAINDER  OF  HELP  TEXT  FOR  THE  'A'  ABBREVIATION 

AIM  AIM  AIM  CLI  Runn i ng  More. .  AF 

SYNTAX  EXAMPLES 

ASSOCIATE 

The  ASSOCIATE  command  maps  a  specified  portion  of  a  window  onto  an 
image.  Assuming  that  n  =  <length>  and  p  =  <position>,  the  ASSOCIATE 
command  maps  the  last  n  lines  of  the  specified  window  onto  the  given 
image  starting  at  the  pth  line  of  the  image.  For  example, 

ASSOC  WIN_1  I M_1  13  12 

will  map  the  last  12  lines  of  WIN_1  onto  lines  13.. 24  of  IM_1.  This 
forms  an  abstract  association  between  WIN_1  and  IM_1  by  creating  a 
viewport  (lines  13  thru  24)  onto  which  the  last  12  lines  of  WIN_1  are 
mapped.  This  viewport  partitions  the  image  vertically,  and  its  width  is 
equal  to  the  width  of  the  image. 

Note:  A  window  may  be  associated  with  more  than  one  image  at  the  same 
time;  however,  a  specific  window  may  only  be  associated  with  a  specific 
image  once. 

Additional  Information  Available: 

{ F4 } 

BOTTOM-OF-SCREEN 


Comments:  More  help 

Command:  { F4 } 
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MORE  HELP 


AIM  AIM  AIM  CLI  Running  AF 

The  ASSOCIATE  command  maps  a  specified  portion  of  a  window  onto  an 
image.  Assuming  that  n  =  <length>  and  p  =  <position>,  the  ASSOCIATE 
command  maps  the  last  n  lines  of  the  specified  window  onto  the  given 
image  starting  at  the  pth  line  of  the  image.  For  example, 

ASSOC  W I N_1  IM_1  13  12 

will  map  the  last  12  lines  of  WIN_1  onto  lines  13.. 24  of  IM_1.  This 
forms  an  abstract  association  between  WIN_1  and  IM_1  by  creating  a 
viewport  (lines  13  thru  24)  onto  which  the  last  12  lines  of  WIN_1  are 
mapped.  This  viewport  partitions  the  image  vertically,  and  its  width 
equal  to  the  width  of  the  image. 

Note:  A  window  may  be  associated  with  mere  than  one  image  at  the  same 
time;  however,  a  specific  window  may  only  be  associated  with  a  specif 
image  once. 

Additional  Information  Available: 

SYNTAX 

COMMAND_PARAMETERS 
topic?  ASSOC  * 

BOTTOM-OF-SCREEN 


EXAMPLES 

ERRORS 


Comments:  Since  a  UNIQUE  AIM  topic  was  NOT  matched  the  HELP  ut i 

prompts  for  another  topic.  In  other  words,  the  HELP  utility  could 
begin  a  traversal  of  the  HELP  tree  since  a  uniquely  path  was 
ident i f ied . 


NO' 

NO 


Command:  ASSOC  *  -  "ASSOC"  uniquely  identifies  the  ASSOCIATE  command.  "* 
queries  for  ALL  available  HELP  information  supported  for  the  ASSOCIAT 
command.  This  includes  the  top  level  ASSOCIATE  information  along  wit 
information  for  all  subtopics. 
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COMMAND_PARAMETERS  ERRORS 

topic?  ASSOC  * 

ASSOCIATE 

The  ASSOCIATE  command  maps  a  specified  portion  of  a  window  onto  an 
image.  Assuming  that  n  =  <length>  and  p  =  <position>,  the  ASSOCIATE 
command  maps  the  last  n  lines  of  the  specified  window  onto  the  given 
image  starting  at  the  pth  line  of  the  image.  For  example, 

ASSOC  WIN  1  IM  1  13  12 


will  map  the  last  12  lines  of  WIN_1  onto  lines  13.. 24  of  IM_i.  This 
forms  an  abstract  association  between  WIN_1  and  IM_1  by  creating  a 
viewport  (lines  13  thru  24)  onto  which  the  last  12  lines  of  WIN_1  are 
mapped.  This  viewport  partitions  the  image  vertically,  and  its  width  is 
equal  to  the  width  of  the  image. 


Note:  A  window  may  be  associated  with  more  than  one  image  at  the  same 
•rime;  however,  a  specific  window  may  only  be  associated  with  a  specific 
image  once. 

{ F  4 } 


BOTTOM-OF- SCREEN 


Comments:  The  HELP  information  has  filled  up  the  AIM  window.  The  "More.." 
indicator  is  on  in  the  viewport  header.  This  informs  the  user  that  the 
window  output  has  been  suspended  because  the  window  is  full  and  the  suspend 
on  full  window  output  mode  is  set  ("F”  setting  in  viewport  header).  The 
HELP  utility  prompts  the  user  for  a  carriage  return  in  order  to  display  the 
next  page  of  the  window's  output. 

Command:  { F 1 0  ?  -  display  next  page  of  window's  output. 
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FETCH  ALL  INFO  ON  ASSOCIATE 


AIM  AIM  AIM  CLI  Running  More..  AF 

SYNTAX  EXAMPLES 

COMMAND  PARAMETERS  ERRORS 


SYNTAX 


ASSOCIATE  WINDOW  NAME 

->  <window  name> 

IMAGE  NAME 

->  <image  name> 

TOP 

*>  <positTon> 

LENGTH 

->  <length> 

COMMAND_PARAMETERS 

W I NDOW_NAME  => 

<windov  name> 

Specifies  the  window  whose  last  <length>  lines  are  to  be  mapped  ont 
the  specified  image. 

IMAGE_NAME  =  >  < image_name> 

Specifies  the  image  onto  which  a  portion  of  the  given  window  will  be 
mapped. 

{F4} 

BOTTOM-OF-SCREEN 


Comments:  More  on  the  ASSOCIATE  topic 

Command:  { F4 } 
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MORE  HELP 

AIM  AIM  AIM  CLI  Running  More..  AF 

Specifies  the  starting  position  for  the  association  relative  to  the  t 
of  the  specified  image. 

LENGTH  =>  <ier.gth> 

Specifies  the  length  of  the  viewport  used  for  the  requested 
association.  In  addition  to  the  viewport  header,  at  least  one  line  of 
window  must  be  displayed  in  a  viewport;  therefore,  the  minimum  length 
allowable  is  2. 

EXAMPLES 

Long  Form:  AIM^  ASSOCIATE  W I NDOW_N AME  =>  W_1 

IMAGE_NAME  =  >  I_1 
TOP  =>  1 
LENGTH  =>  24 

Associate  the  entire  contents  of  window  W_1  with  the  image  I_l. 

Mixed  Form:  AIM>  ASSOC  WIN_2  IMAGE_NAME  =>  IM__2  1  LENGTH  =>  8 

Associate  the  last  8  lines  of  window  WIN_2  with  the  first  8  lines  of 

BOTTOM-OF- SCREEN 


Comments:  Mere  on  ASSOCIATE 

Command:  ?F4; 
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AIM  AIM  AIM  CLI  Running  More.  AF 

Short  Form:  AIM>  AS  WIN_3  IM_3  9  8 

Associate  the  last  8  lines  of  window  WIN_3  with  lines  9  thru  16  of 
image  IM_1. 

ERRORS 

The  semantic  errors  associated  with  this  command  include: 

"Window  <window_name>  does  not  exist" 

The  specified  window  name,  <window_name> ,  does  NOT  exist  (i.e.--  no 
window  of  that  name  has  been  created). 

"Image  <image_name>  does  not  exist" 

The  specified  image  name,  < image_name> ,  does  NOT  exist  (i.e.--  no  im 
of  that  name  has  been  created). 

"Invalid  length:  <length>" 

The  specified  viewport  length  was  wither  out  of  range,  non-numeric, 

BOTTOM-OF-SCREEN 


Comments:  MORE  HELP 

Command:  { F4 } 
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MORE 


HELP 


AIM  AIM  AIM  CLI  Running  AF 

The  specified  image  name,  < image_name> ,  does  NOT  exist  (i.e.--no  *mace 
of  that  name  has  been  created). 

"Invalid  length:  <length>" 

The  specified  viewport  length  was  either  out  of  range,  non-numeric,  or 
tcc  long  to  ensure  non- intersect  ir.g  viewports  of  the  given  image. 

"Invalid  top  line:  <top_l ine>? 

The  specified  top  line  for  starting  the  viewport  was  either  out  of 
range,  or  non-numeric. 

"Association  between  specified  window  and  image  already  exists 

The  specified  window  is  currently  associated  with  < imace_name >  and  the 
AIM  prohibits  multiple  associations  between  the  same  window  and  image. 

"Cannot  map  another  window  onto  the  AIM  image" 

The  AIM  image  and  window  cannot  oe  altered  oy  the  user. 

ASSOCIATE  subtopic?  ? 

BOTTOM -OF- SCREEN 


Comments :  Upon 

displayed  and 
HELP  command  ma 


the  carriage  return  the  remainder  of  the 
the  "More..”  indicator  is  NO  longer  present, 
ched  ASSOCIATE,  so  the  "ASSOCIATE  Subtopic^" 


HELP  text 
The  "ASSOC 
appears . 


Command:  ?  -  invoke  the  implicit  help  operator  to  display  a  list  of 

allowable  responses  to  the  "ASSOCIATE  Subtopic"  prompt. 
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IMPLICIT  HELP  AT  ASSOCIATE  SUBTOPIC  LEVEL 


AIM  AIM  AIM  CLI  Running  More..  AF 

"Invalid  top  line:  <top_line>" 

The  specified  top  line  for  starting  the  viewport  was  either  out  of 
range,  or  non-numeric. 

"Association  between  specified  window  and  image  already  exi 

The  specified  window  is  currently  associated  with  <image_name>  and 
AIM  prohibits  multiple  associations  between  the  same  window  and  ima 

"Cannot  map  another  window  onto  the  AIM  image" 

The  AIM  image  and  window  cannot  be  altered  by  the  user. 

ASSOCIATE  subtopic?  ? 

The  ASSOCIATE  command  maps  a  specified  portion  of  a  window  onto  an 
image.  Assuming  that  n  =  <length>  and  p  =  <position>,  the  ASSOCIAT 
command  maps  the  last  n  lines  of  the  specified  window  onto  t.ne  give 
image  starting  at  the  pth  line  of  the  image.  For  example, 

ASSOC  WIN_1  IM_1  13  12 { F4 } 

BOTTOM-OF-SCREEN 


Comments:  More  help 


Command:  {F4} 
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Not  e :  A 

w  i  no 

ow  may  be 

assoc i at ed 

v 1 1  h  mo  r e  t  h  a n 

one  imaq 

e  a 

t  the  same 

time;  ho 

v  e  v  e 

r  f  a  spec i 

f i c  w i ndow 

may  only  be  as 

soc i at  ed 

w  1  t 

n  a  specif 

image  once. 

Add i t i on a i  Information  Available: 

1 

NT AX  EXAMPLES 

MMAND_?ARAMZTERS  ERRORS 

SCC I  ATE  subtopic?  {return} 

BOTTOM “OF -SCREEN 


mrents:  The  HELP  text  for  ASSOCIATE  is  redisplayed  along  with  the  lis 

HELP  supported  subtopics.  In* this  case,  only  the  keyword  "Parameters 
succor ted  under  the  ASSOCIATE  command. 


nr. and :  { 

evicts  HE 


^  P  7  P  _ 


No  mo  re  information  at  this  1 e  v e  ‘ 


re1 


to 


:h 
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RETURN  TC  HELP  TOP  LEVEL 


AIM 

AIM  AIM  CL 

I  Running 

> 

comma n 

d  .TiaDs  t r.e  las*  n  I: 

nes  of  the  spec: 

f  i  eo 

w  ; 

ncc 

w  j  n 

t  o  t  h  e  g  :  v 

p 

image 

starting  at  the  pth 

line  of  the  mag 

e .  F 

c  r 

ex 

amp  i 

p  . 

ASSO 

c  w : n  i  : m  *  13 

'  p 

V  1  1  *  T. 

ap  the  last  12  lines 

of  WIN  1  onto  1 

:  nes 

3 

•  .  c 

4  o £ 

IM  1.  T.m 

s 

f  o  rms 

an  abstract  as sociat 

ion  between  WIN 

1  and 

r 

M  1 

by 

treat i nc  a 

v ; evcc 

r t  Clines  13  thru  24 

)  onto  which  the 

last 

- 

.nes 

of  win  : 

are 

mapped 

.  This  viewport  part 

it  ions  tne  image 

v  e  r  t 

i  : 

a  1  i 

y  *  5 

rd  its  wid 

t  h 

equa  1 

: o  tne  width  of  the 

image . 

Note  . 

A  window  may  be  as so 

ciated  with  mere 

t  han 

Q 

n  e 

imag 

e  at  the  s 

ame 

t  ime ; 

ncvever,  a  specific 

w  i  ndow  may  o n 1 y 

be  as 

3  C 

c  i  a 

ted  ' 

with  a  spe 

~  c 

image 

o  r.  c  e 

Add  i  t  ior.a  1 

Informat  i o r.  Ava :  1  a l 

e  : 

SYNTAX 

EXAMFL 

ES 

COMMAND  PAR 

A.VE7EHS 

FTRCRS 

ASSOCIATE  subtop ic ? 

Topic?  CERATE 

BOTTOM  -Or -SC P E E N 


Comments:  Toe  user  has  returned  to  the  top  level  of  tne 

"Topic?”  prompt  reappears. 


*ee ; 


Command :  CERATE 

error . 


i  s 


is  ar  unrecognizable 


HELP  Keyword 


:  s  i  n  q 
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HELP  ERROR  MESSAGE 


AIM  AIM  AIM  CLI  Running  More..  AF 

will  map  the  last  12  lines  of  WIN_1  onto  lines  13.. 24  of  IM_1.  This 
forms  an  abstract  association  between  WIN_1  and  IM_1  by  creating  a 
viewport  (lines  13  thru  24)  onto  which  the  last  12  lines  of  WIN_1  are 
mapped.  This  viewport  partitions  the  image  vertically,  and  its  width  is 
equal  to  the  width  of  the  image. 


Note:  A  window  may  be  associated  with  more  than  one  image  at 
time:  however,  a  specific  window  may  only  be  associated  with 
image  once. 


the  same 
a  specific 


Additional  Information  Available: 


SYNTAX 

COMMAND_PARAMETERS 

ASSOCIATE  subtopic?  {return} 

Topic?  CERATE 

Sorry,  no  documentation  available  on  CERATE 

Additional  Information  Available: 

{F4} 

BOTTOM-OF-SCREEN 


EXAMPLES 

ERRORS 


Comments:  More  help 
Command:  { F4 } 
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MORE  HELP 


AIM  AIM 

AIM  CLI 

Runn i ng 

SYNTAX 

EXAMPLES 

COMMAND_PARAMETERS 

ERRORS 

ASSOCIATE  Subtopic? 

Topic?  CERATE 

Sorry,  no  documentation 

available  on 

CERATE 

Additional  Information  Available: 


ABORT_AIM 

ASSOCIATE 

CREATE 

DEFINE 

DELETE 

DISASSOCIATE 

EXIT 

GOTO 

HELP 


INFO 

KEYSTROKES 

RESET 

RESUME 

SCRIPT 

SET 

SUSPEND 

TERMINATE  EXECUTION 


Topic?  CREATE 


BOTTOM-OF-SCREEN 


Comments:  The  "CERATE"  keyword  was  not  recognized  by  HELP.  A  list  of  the 

available  HELP  topics  was  displayed,  and  the  "Topic?"  prompt  reappears. 


Command:  CREATE  -  display  the  HELP  information  available  for  the  AIM 

CREATE  command. 
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DISPL/  i  TC”  I.E'T 


AIM  AIM 

Additional  Information  Av  .. 

A30RT_AIM 

ASSOCIATE 

CREATE 

DEFINE 

DELETE 

DISASSOCIATE 

EXIT 

Gr\rr\f\ 

*  O 

HELP 

Topic?  CREATE 
CREATE 


COMMAND 


AF 


'  .VC 

•\c,YST:v>  r'S 

RESET 

RESUME 

SCRIPT 

SET 

SUSPEND 

TERMINATE  EXECUTION 


The  CREATE  command  allows  the  user  to  create  a  window  or  an  image. 
Additional  Information  Available: 


IMAGE 


WINDOW 


CREATE  suotop 


BOTTOM-OF - SCREEN 


Comments:  The  HELP  text  supported  for  the  AIM  CREATE  command  is  being 

displayed. 

Command:  *  -  request  to  display  ALL  the  HELP  information  in  CREATE 

subtree . 
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DISPLAY  ALL  HELP  AVAILABLE  FOR  CREATE  COMMAND 

AIM  CLI  Runn i ng  More . .  AF 

KEYSTROKES 
RESET 
RESUME 
SCRIPT 
SET 

SUSPEND 

TERMINATE  EXECUTION 


Topic?  CREATE 
CREATE 

The  CREATE  command  allows  the  user  to  create  a  window  or  an  image. 
Additional  Information  Available: 

IMAGE  WINDOW 

CREATE  subtopic?  * 


AIM  AIM 

ASSOCIATE 
CREATE 
DEFINE 
DELETE 

DISASSOCIATE 

EXIT 

GOTO 

HELP 


CREATE 

{ F4 } 

BOTTOM-OF-SCREEN 


Comments:  More  help 

Command:  {F4} 


A 
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MORE  HELP 


AIM 

AIM 

AIM  CLI 

Running 

More .  . 

AF 

Add it ional 

Informat  ion 

Available: 

IMAGE 

WINDOW 

IMAGE 

The  CREATE  IMAGE  command  allows  the  AIM  user  to  create  a  new  image  in 
the  AIM  environment.  A  newly  create  image  will  be  alphabetically 
entered  into  the  existing  image  list. 

Note:  There  is  no  explicit  limit  to  the  number  of  images  that  can  be 
i  created  during  an  AIM  session. 

Additional  Information  Available: 

1  SYNTAX  EXAMPLES 

COMMAND_PARAMETERS  ERRORS 

SYNTAX 


{ F  4 } 


CR*EATE  OBJECT_TYPE  =>  I *MAGE  IMAGE_NAME  =>  <image_name> 
BOTTOM-OF-SCREEN 


I 

Comments : 
subtopics 

1  Command: 


All  the  HELP  text  supported  for  the  AIM  CREATE 
is  displayed. 

{F4}  -  display  next  page  of  AIM  window's  output 


command ' s 


k 
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DISPLAY  NEXT  PAGE  OF  AIM  WINDOW'S  OUTPUT 
AIM  AIM  AIM  CLI  Running  More. .  AF 

OBJECT_TYPE  =>  I *MAGE 

Specifies  that  a  new  imaqe  is  to  be  created  in  the  AIM  environment. 

IMAGE_NAME  =>  <image_name> 

Specifies  the  name  of  a  new  image  to  be  created. 

EXAMPLES 

Long  Form:  AIM>  CREATE  OBJECT_TYPE  =>  IMAGE  IMAGE_NAME  =>  IM_ 

Mixed  Form:  AIM>  CREATE  IMAGE  IMAGE_NAME  =>  IM_1 

Short  Form;  AIM>  CR  I  IM_1 

Each  form  creates  an  AIM  image  named  IM_1. 

ERRORS 

The  semantic  errors  associated  with  this  command  include: 

"Image  name,  < image  name>,  already  in  use" 

{F4 } 

BOTTOM-OF-SCREEN 


Comments:  More  help 

Command:  {F4} 
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AIM  AIM  AIM  CLI  Running  More..  AF 

"Identifier  name  is  too  long" 

The  specified  image  name  was  longer  than  20  characters. 

WINDOW 

The  CREATE  WINDOW  command  allows  the  AIM  user  to  create  a  new  window  i 
the  AIM  environment.  A  newly  created  image  will  be  alphabetically 
entered  into  the  existing  image  list. 

Note:  There  is  no  explicit  limit  to  the  number  of  windows  that  can  be 
created  during  an  AIM  session. 

The  default  values  for  the  new  window's  flag  settings  follow: 

SUSPENDS_OUTPUT_ON_FULL  -  true, 

I NPUT_COMPONENT_ACT I VE  -  false, 

OUTPUT_COMPONENT_ACT I VE  -  false, 

OUTPUT_SUSPENDED  -  false. 

Additional  Information  Available: 

{ F4 } 

BOTTOM-OF-SCREEN 


Comments:  More  help 

Command:  {F4} 
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AIM  AIM  AIM  CLI  Running  More..  A? 

COMMAND_PARAMETERS  ERRORS 

SYNTAX 

CR*EATE  OBJECT_TYPE  =>  W*INDOW  WINDOW_NAME  =>  <vindOW_nsme 
CCMMAND_PARAMETERS 

OBJECT_TYPE  =>  W*INDGW 

Specifies  that  a  new  window  is  to  be  created  in  the  AIM  environment. 

WINDOW_NAME  =>  <window__name> 

Specifies  the  name  of  a  new  window  to  be  created. 

EXAMPLES 

Long  Form:  AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  WINDOW_NAME  ->  WI 

Mixed  Form:  AIM>  CREATE  WINDOW  W I NDOW_NAME  =>  WIN_1 

Short  Form:  AIM>  CR  W  WIN_1 

Eauh  form  creates  an  AIM  window  named  WIN_3.{F4} 

BOTTOM-OF-SCREEN 


Comments:  More  help 

Command:  { F4 } 
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AIM  AIM  AIM  CLI  Running  AF 

Long  Form:  AIM>  CREATE  OBJECT_TYPE  =>  WINDOW  W I NDOW_NAME  =>  WIN 

Mixed  Form:  AIM>  CREATE  WINDOW  WINDOW_NAME  =>  WIN_1 

Short  Form:  AIM>  CR  W  WIN_1 

Each  form  creates  an  AIM  window  named  WIN_3. 

ERRORS 

The  semantic  errors  associated  with  this  command  include: 

"Window  name,  ^window_name> ,  already  in  use" 

The  specified  window  name  already  exists  in  the  AIM  environment. 

"Identifier  name  is  too  long" 

The  specified  window  name  was  longer  than  20  characters. 

"Could  not  create  a  process  for  window:  <window_name>" 

Access  has  oeen  denied  to  disk  or  disk  quota  has  been  exceeded. 

CREATE  Subtopic?  { F10 } 

_ BOTTOM-OF-SCREEN _ 

Comments:  All  the  remaining  HELP  text  supported  for  the  AIM  CREATE 

command's  subtopics  has  been  displayed 

Command:  { F i 0 }  -  Exit  the  HELP  utility  from  the  present  state.  This  is  a 

keystroke  command. 
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ISSUE  AIM  EXIT  COMMAND 

“AIM  AIM  AIM  CLI  Running  AF 

Mixed  Form:  AIM>  CREATE  WINDOW  W I NDOW_NAME  =>  WIN_1 

Short  Form:  AIM>  CR  W  WIN_1 

Each  form  creates  an  AIM  window  named  WIN_3. 

ERRORS 

The  semantic  errors  associated  with  this  command  include: 

"Window  name,  <window_name> ,  already  in  use" 

The  specified  window  name  already  exists  in  the  AIM  environment. 

"Identifier  name  is  too  long" 

The  specified  window  name  was  longer  than  20  characters. 

"Could  not  create  a  process  for  window:  <wi ndow_name> " 

Access  has  been  denied  to  disk  or  disk  quota  has  been  exceeded. 

CREATE  Subtopic?  { FI 0 } 

AIM>  EXIT 

_ BOTTOM-OF-SCREEN _ 

Comments:  The  { F 1 0 }  Swi tch_to_AIM  keystroke  command  exits  HELP  and  the 

"AIM>"  prompt  reappears. 

Command:  EXIT  -  Exit  the  AIM  program. 
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EXIT  AIM  SESSION 

Mixed  Form:  AIM>  CREATE  WINDOW  WINDOW_NAME  =>  WIN_1 

Short  Form:  AIM>  CR  W  WIN_1 

Each  form  creates  an  AIM  window  named  WIN_3. 

ERRORS 

The  semantic  errors  associated  with  this  command  include: 

"Window  name,  <window_name> ,  already  in  use" 

The  specified  window  name  already  exists  in  the  AIM  environment. 

"Identifier  name  is  too  long" 

The  specified  window  name  was  longer  than  20  characters. 

"Could  not  create  a  process  for  window:  <window_name>" 

Access  has  been  denied  to  disk  or  disk  quota  has  been  exceeded. 

CREATE  Subtopic?  { FI 0 } 

AIM>  EXIT 
-) 

_ BOTTOM-OF-SCREEN _ 

Comments:  The  AIM  has  terminated  its  execution  and  the  prompt  from  the 

underlying  APSE  reappears. 

Command:  None. 
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A. 7  SESSION  7  -  AIM  INFO  UTILITY 


The  AIM  INFO  Utility  session  explains  the  use  of  the  INFO 
The  INFO  command  gives  the  user  information  on  the  current 
associations,  keystrokes,  and  mode  settings.  The  ut i j 
successive  levels  of  information  and  is  based  on  the  same 
the  HELP  utility.  The  following  text  files  are  used  in  this 


demol.  i 

aim 

CREATE 

IMAGE 

IMAGE  1 

CREATE 

IMAGE 

IMAGE  2 

CREATE 

WINDOW 

WINDOW 

A 

CREATE 

WINDOW 

W I NDOW* 

'3 

CREATE 

WINDOW 

W I NDOW- 

'C 

CREATE 

WINDOW 

WINDOW- 

"d 

ASSOC 

WINDOW  A 

IMAGE- 

'1 

1 

8 

ASSOC 

WINDOW  B 

IMAGE 

"l 

9 

8 

ASSOC 

WINDOW  C 

IMAGE" 

'1 

17 

8 

ASSOC 

WINDOW  C 

IMAGE- 

'2 

1 

12 

ASSOC 

WINDOW  D 

IMAGE- 

'2 

13 

12 

command . 
status  of 
ity  has 
format  as 
session: 


A-158 


PAGE  TERMINAL  TUTORIAL 
SESSION  7  -  AIM  INFO  UTILITY 


INVOKE  AIM  FROM  APSE 

-)  AIM 


_ BOTTOM-OF-SCREEN _ 

Comments: 

Command:  AIM  -  invoke  the  AIM  from  the  APSE. 
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SWITCH  TO  AIM  IMAGE 


MAIN 


MAIN  FRCH:0I6  Running 


AOS/VS  CLI  REV  05. 01. 00. CO 


9-APR-85 


1  3 


26:43  < F *  I 


BOTTOM-OF -SCREEN 


Comments:  The  AIM  initializes  the  current  image  to  be  MAIN.  To  e.nt 

textual  command  the  user  must  communicate  through  the  AIM  image  to 
command  interpreter. 

Command:  { F 1 0 }  -  Set  the  current  image  to  be  the  AIM  image. 
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rt  (T> 


l i.  iL rvM  i.  i* /\ w  a  u  i.  wiv  * 

SESSION  7  -  AIM  INFO  UTILITY 


INVOKE  DEMOl  SCRIPT 

_ AIM  AlM  AIM  CL I  Running  AF 

AIM>  SCRIPT  "demol .aim" 


BOTTOM-OF-SCREEN 


Comments:  The  AIM  image  is  initially  blank. 

Command:  SCRIPT  "demol. aim"  invoke  the  execution  of  a  command  script.  The 

script  resides  in  the  file  DEMO 1 . 
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ECHO  SCRIPT  LINES 


AIM 

AIM  AIM  CLI 

Running 

AIM> 

SCRIPT 

"demol . aim" 

AIM> 

CREATE 

IMAGE  xMAGE  1 

AIM> 

CREATE 

IMAGE  IMAGE  2 

AIM> 

CREATE 

WINDOW  WINDOW  A 

AIM> 

CREATE 

WINDOW  WINDOW  B 

AIM> 

CREATE 

WINDOW  WINDOW  C 

AIM> 

CREATE 

WINDOW  WINDOW  D 

AIM> 

ASSOC 

WINDOW  A  IMAGE  1 

1 

8 

AIM> 

ASSOC 

WINDOW  B  IMAGE  1 

9 

8 

AIM> 

ASSOC 

WINDOW  C  IMAGE  1 

17 

8 

AIM> 

ASSOC 

WINDOW  C  IMAGE  2 

1 

12 

AIM> 

ASSOC 

WINDOW  D  IMAGE  2 

13 

12 

AIM> 

INFO 

BOTTOM-OF -SCREEN 


Comments:  The  AIM  command  interpreter  has  echoed  each  command  line  of  the 

script  as  it  was  being  executed. 

Command:  INFO  -  invoke  AIM  INFO  utility. 
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THE  AIM  INFO  UTILITY 


AIM  AIM  AIM  CLI  Running  AF 


AIM> 

SCRIPT 

"demol .aim" 

AIM> 

CREATE 

IMAGE 

IMAGE  1 

AIM> 

CREATE 

IMAGE 

IMAGE  2 

AIM> 

CREATE 

WINDOW 

WINDOW 

A 

AIM> 

CREATE 

WINDOW 

WINDOW 

B 

AIM> 

CREATE 

WINDOW 

WINDOW 

C 

AIM> 

CREATE 

WINDOW 

WINDOW 

D 

A  IM> 

ASSOC 

WINDOW  A 

IMAGE 

1 

1 

8 

AIM> 

ASSOC 

WINDOW  B 

IMAGE 

1 

9 

8 

AIM> 

ASSOC 

WINDOW  C 

IMAGE 

1 

17 

8 

AIM> 

ASSOC 

WINDOW  C 

IMAGE 

2 

1 

12 

A  IM> 

ASSOC 

WINDOW  D 

IMAGE 

2 

13 

12 

AIM> 

INFO 

Info  is  available  for  the  following  AIM  objects: 

IMAGES 

KEYSTROKES 

TERMINAL 

WINDOWS 

INFO  Object?  IM 


BOTTOM-OF-SCREEN 


Comments:  The  INFO  utility  lists  ALL  the  AIM  objects  for  which  information 
is  available.  When  INFO  prompts  for  an  object  name,  key  in  one  of  the  AIM 
keywords  from  the  list. 

Command:  IM  -  The  "IM"  is  an  valid  abbreviation  for  the  INFO  keyword 
"IMAGES".  The  command  requests  an  alphabetical  listing  of  ALL  the  current 
images  in  the  AIM  environment. 
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ALPHABETICAL  IMAGE  NAME  LIST 


AIM 

AIM 

AIM  C LI 

Running 

AIM> 

CREATE 

IMAGE 

IMAGE  1 

AIM> 

CREATE 

IMAGE 

IMAGE  2 

AIM> 

CREATE 

WINDOW 

WINDOW 

A 

AIM> 

CREATE 

WINDOW 

WINDOW 

B 

AIM> 

CREATE 

WINDOW 

WINDOW 

C 

AIM> 

CREATE 

WINDOW 

WINDOW 

D 

AIM> 

ASSOC 

WINDOW  A 

IMAGE 

1 

1 

8 

AIM> 

ASSOC 

WINDOW  B 

IMAGE 

1 

9 

8 

AIM> 

ASSOC 

WINDOW  C 

IMAGE 

1 

17 

8 

AIM> 

ASSOC 

WINDOW  C 

IMAGE 

2 

1 

12 

AIM> 

ASSOC 

WINDOW  D 

IMAGE 

2 

13 

12 

AIM> 

INFO 

Info  is  available  for  the  following  AIM  objects: 

IMAGES 

KEYSTROKES 

TERMINAL 

WINDOWS 

INFO  Object?  IM 

The  current  AIM  images  include:  { F 4 } 

BOTTOM-OF-SCREEN 


Comments:  More  Info 

Command:  { F4 } 
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MORE  INFO 


AIM 

AIM 

AIM  \ 

CLI 

Running 

AIM> 

ASSOC 

WINDOW  B 

IMAGE  1 

9 

8 

AIM> 

ASSOC 

WINDOW  C 

IMAGE  1 

17 

8 

AIM> 

ASSOC 

WINDOW  C 

IMAGE  2 

1 

12 

AIM> 

AIM> 

ASSOC 

INFO 

WINDOW  D 

IMAGE  2 

13 

12 

Info 

is  available  for 

the  following 

AIM 

object 

IMAGES 

KEYSTROKES 

TERMINAL 

WINDOWS 

INFO  Object?  IM 

The  current  AIM  images  include: 

AIM 

IMAGE_1 

IMAGE_2 

MAIN 

INFO  Image  Name?  MAIN 

BOTTOM-OF-SCREEN 


Comments:  The  INFO  utility  lists  ALL  active  images  and  then  prompts  the 
user  to  see  if  more  information  is  requested  about  a  specific  image. 

Command:  MAIN  -  request  for  the  available  information  on  the  image  MAIN. 
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INFO  ON  MAIN 


AIM  AIM  AIM  CLI  Running  AF 

IMAGES 
KEYSTROKES 
TERMINAL 
WINDOWS 

INFO  Object?  IM 

The  current  AIM  images  include: 

AIM 

IMAGE_i 
IMAGE_2 
MAIN 

INFO  Image  Name?  MAIN 

Image  Name:  MAIN 

Window  Associations: 

Window  Name  Top  Line 

MAIN  1 

INFO  Image  Name?  AIM 

BOTTOM-OF-SCREEN 


Viewport  Length 
24 


Comments:  The  INFO  utility  now  displays  ALL  the  information  available  fo 

MAIN.  INFO  prompts  the  user  for  another  image  name. 

Command:  AIM  -  Request  info  on  AIM. 
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INFO  ON  AIM 

AIM  AIM  AIM  CLI  Running  aF 

AIM 

IMAGE_1 

IMAGE_2 

MAIN 

INFO  Image  Name?  MAIN 
Image  Name:  MAIN 
Window  Associations: 

Window  Name  Top  Line  Viewport  Length 

MAIN  1  24 

INFO  Image  Name?  AIM 

Image  Name:  AIM 

Window  Associations: 

Window  Name  Top  Line  viewport  Length 

AIM  1  24 

INFO  Image  Name?  IMAGE_1 

BOTTOM-OF-SCREEN 


Comments:  Now  displayed  is  all  the  information  available  for  AIM.  Again 

INFO  prompts  the  user  for  another  image  name. 

Command:  IMAGE  1 
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INFO  ON  IMAGE  1 


AIM  AIM  AIM  CLI  Running 

AIM 

IMAGE_1 

IMAGE_2 

MAIN 

INFO  Image  Name?  MAIN 
Image  Name:  MAIN 
Window  Associations: 

Window  Name  Top  Line  Viewport  Length 

MAIN  1  24 

INFO  Image  Name?  AIM 

Image  Name:  AIM 

Window  Associations: 

Window  Name  Top  Line  Viewport  Length 

AIM  1  24 

INFO  Image  Name?  IMAGE  1 
{ F4  } 

BOTTOM-OF- SCREEN 


Comments:  More  info 

Command:  { F4 } 


More . 
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MORE  INFO 


AIM  AIM  AIM  CLI 

Window  Associations: 

Window  Name  Top  Line 

i  MAIN  1 


Running 

Viewport  Length 
24 


INFO  Image  Name?  AIM 
Image  Name:  AIM 


Window  Associations: 

Window  Name 

AIM 


Top  Line 
1 


Viewport  Length 
24 


INFO  Image  Name?  IMAGE_1 


Image  Name:  IMAGE_1 


Window  Associations 
Window  Name 
wiNDOW_A 
WINDOW_B 
WINDOW  C 


Top  Line 
1 
9 

17 


Viewport  Length 
8 
8 
8 


INFO  Image  Name?  {return} 

BOTTOM-OF-SCREEN 


AF 


1  Comments:  The  INFO  utility  displays  ALL  the  information  available  for 
IMAGE_1.  Note  that  the  prompt  is  for  another  image  name  as  there  are  NO 

I  further  sublevels  of  information  available  for  images.  In  this  case,  ALL 
the  available  information  for  IMAGE_1  has  been  displayed;  INFO  prompts  the 
user  for  another  image  name. 

I  Command:  {return}  -  return  to  the  previous  INFO  level. 
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RETURN  TO  TOP  LEVEL  OF  INFO  TREE 

AIM  ATM  AIM  CLI  Running  AF 

Window  Name  Top  Line  Viewport  Length 

MAIN  1  24 

INFO  Image  Name?  AIM 

Image  Name:  AIM 

Window  Associations: 

Window  Name  Top  Line  Viewport  Length 

AIM  1  24 

INFO  Image  Name?  IMAGE_1 

Image  Name:  IMAGE_1 

Window  Associations: 

Window  Name  Top  Line 

W I NDOW_ A  1 

WINDOW_3  9 

W I NDOW_C  17 

INFO  Image  Name? 

INFO  Object?  KEYS 

BOTTOM-OF-SCREEN 


Comments:  The  carriage  return  in  response  to  the  "INFO  Image  Name?"  prompt 
caused  the  "INFO  Object?"  to  reappear.  The  current  INFO  level  is  now  the 
top  level. 

Command:  KEYS  -  list  ALL  keystroke  command  names  alphabetically. 


Viewport  Length 
8 
8 
8 
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LIST  KEYSTROKE  COMMAND  NAMES  ALPHABETICALLY 
AIM  AIM  AIM  CLI  Runn i ng  More .  .  AF 

Window  Associat ions : 

Window  Name  Top  Line  Viewport  Length 

W I NDOW_ A  1  8 

W I ND0W_3  9  8 

W I NDOW_C  17  8 

INFO  Image  Name? 

INFO  Object?  KEYS 

AIM  keystroke  names  include: 

A30RT_SCR I PT 

CLE AR_W I NDOW 

NEXT_IMAGE 

NEXT_PAGE 

NEXT_V I EWPORT 

PREVIOUS_IMAGE 

PREV I OUS_V I EWPORT 

REDI SPLAY_SCREEN 

RETURN_TO_PRE V_ I MAGE 

SWITCH  TO  AIM 

{F4} 

BOTTOM-OF-SCREEN 


Comments:  More  info 

Command:  {F4} 
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MORE  INFO 


AIM  AIM 

AIM  CLI 

Runn i ng 

Window  Associations: 
Window  Name 

Top  Line 

Viewport 

WINDOW  A 

1 

8 

WINDOW  B 

9 

8 

WINDCW_C 

17 

8 

INFO  Image  Name? 

INFO  Object?  KEYS 

AIM  keystroke  names 

include: 

ABORT_SCR I PT 
CLEAR_W I NDOW 
NEXT_IMAGE 
NEXT_PAGE 
NEXT_V I EWPORT 
PREVIOUS_IMAGE 
PREV I OUS_V I EWPORT 
RED I SPLAY_SCREEN 
RETURN_70_? REV  IMAGE 
SW I TCH_TO_A I M 

INFO  Keystroke  Name?  * 

BOTTOM-OF-SCREEN 


AF 


Comments:  INFO  displays  an  alphabetical  listing  of  ALL  the  AIM  keystrc 
command  names  and  asks  the- user  if  more  info  is  desired  about  a  specif 
keystroke . 

Command:  *  -  list  ALL  keystroke  command  to  key  sequence  associations. 
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LIST  ALL  KEYSTROKE  TO  KEY  SEQUENCE  BINDINGS 


AIM  AIM  AIM  CLI  Running  AF 

NEXT_V I EWPORT 
PREVIOUS_IMAGE 
PREV I OUS_V I EWPORT 
REDISPLAY_SCREEN 
RETURN_TO_PREV_ I MAGE 
SWITCH  TO  AIM 


INFO  Keystroke  Name0  * 

Keystroke  Command  Name  Key  Sequence 


A30RT_SCR I PT  FI 

C  L  E AR_W I NDOW  F2 

NEXT_IMAGE  F3 

NEXT_PAGE  F4 

NEXT_V I EWPORT  F5 

PREVIOUS_IMAGE  F6 

PREV I OUS_V I EWPORT  F7 

REDI SPLAY_SCREEN  F8 

RETURN_TO_PREV I OUS_ I MAGE  F9 

SWITCH  TO  AIM  F10 


INFO  Keystroke  Name?  {return} 

BOTTOM-OF- SCREEN 


Comments:  INFO  displays  an  alphabetical  listing  of  ALL  the  AIM's  keystroke 

command  names  with  their  associated  key  sequence. 

Command:  {return}  -  return  to  previous  INFO  level. 
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RETURN  TO  PREVIOUS  INFO  LEVEL 


AIM  AIM  AIM  CLI 

PREVICUS_IMAGE 
PREV I OUS_V I EWPORT 
REDISPLAY_SCREEN 
RETURN_TO_P RE  V_ I MAG  E 
SW I TCH_TO_A I M 

INFO  Keystroke  Name?  * 


Running 


Keystroke  Command  Name 

ABORT_SCR I PT 

CLEAR_W I NDOW 

NEXT_IMAGE 

NEXT_PAGE 

NEXT_V I EWPORT 

PREV I CUS_ I MAGE 

PREV I OUS_V I EWPORT 

REDI SPLAY_SCREEN 

RETURN_TO_PREV I OUS_ IMAGE 

SW I TCH_TO_A I M 

INFO  Keystroke  Name? 

INFO  Object?  TERMINAL 


Key  Sequence 

FI 
F2 
F  3 
F  4 
F5 
F6 
F7 
F8 
F9 
FI  0 


BOTTOM-OF-SCREEN 


Comments:  The  "INFO  Object?"  prompt  reappears. 

Command:  TERMINAL  -  request  for  the  information  available  or.  the  termiral. 
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RETURN  TO  PREVIOUS  INFO  LEVEL 

AIM  ATM  AIM  CLI  Running 

SWITCH  TO  AIM 


INFO  Keystroke  Name?  * 

Keystroke  Command  Name  Key  Sequence 


ABORT_SCR I PT  FI 

CLEAR_W I NDOW  F2 

NEXT_IMAGE  F3 

NEXT_PAGE  F4 

NEXT_V I EWPORT  F5 

PREVIOUS_IMAGE  F6 

PREV I OUS_V I EWPORT  F7 

RED I SPLAY_SCREEN  F8 

RETURN_TO_PRE V I OUS_ I MAGE  F9 

SWITCH  TO  AIM  F10 


AF 


INFO  Keystroke  Name? 

INFO  Object?  TERMINAL 

Terminal  Type:  UNDEFINED 

INFO  Object?  WINDOW  MAIN 

_  BOTTOM-OF-SCREEN 


Comments:  The  "INFO  Object?"  prompt  reappears.  Note  the  terminal  type 

will  be  the  name  of  the  terminal  being  used. 

Command:  WINDOW  MAIN  -  request  for  ALL  the  information  available  on  the 

window  MAIN.  Note  that  response  can  be  combined. 
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WINDOW  MAIN  INFO 


AIM 


AIM  AIM  CLI  Running 


Keystroke  Command  Name 


Key  Sequence 


ABORT_SCR I PT  FI 

CLEAR_W I NDOW  F2 

NEXT_IMAGE  F3 

NEXT_PAGE  F4 

NEXT_V I EWPORT  F5 

PREVIOUS_IMAGE  F6 

PREV I OUS_V I EWPORT  F7 

RED I SPLAY_SCREEN  F8 

RETURN_TO_PREV I OUS_ I MAGE  F9 

SWITCH  TO  AIM  F10 


INFO  Keystroke  Name? 

INFO  Object?  TERMINAL 

Terminal  Type:  UNDEFINED 

INFO  Object?  WINDOW  MAIN 


Window  name:  MAIN 
{F4 } 

BOTTOM-OF- SCREEN 


More .  . 


AF 


Comments:  More  info 

Command:  {F4} 
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MORE  INFO 


AIM  AIM  AIM  CLI  Running  AF 

Input  Pad  Name:  NONE 
Output  Pad  Name:  NONE 

Pad  Mode :  NONE 

Suspend  Output  on  Full  Window:  ON 
Suspend  Output  on  Switch-to-AIM:  ON 
Window  Output  Status:  ACTIVE 

Process:  FRCH:016 

Image  Associations: 

Image  Name  Top  Line  Viewport  Length 

MAIN  1  24 


Information  is  available  for: 

ASSOCIATIONS 

MODES 

PADS 

PROCESS_STATUS 

INFO  Window  MAIN  Sub-block?  {return} 

BOTTOM-OF-SCREEN 


Comments:  The  information  on  the  window  MAIN  is  listed.  The  user  is  given 
the  option  for  more  info  at  lower  levels  (though  not  entered  here). 


Command:  {return} 


return  to  the  previous  level. 
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RETURN  TO  PREVIOUS  INFO  LEVEL 


AIM  AIM  AIM  CLI  Running  AF 

Output  Pad  Name:  NONE 

Pad  Mode :  NONE 

Suspend  Output  on  Full  Window:  ON 
Suspend  Output  on  Switch-to-AIM:  ON 
Window  Output  Status:  ACTIVE 

Process:  FRCH:016 

Image  Associations: 

Image  Name  Top  Line  Viewport  Length 

MAIN  1  24 


Information  is  available  for: 

ASSOCIATIONS 

MODES 

PADS 

PROCESS_STATUS 

INFO  Window  MAIN  Sub-block? 

INFO  Window  name?  WINDOW_A 

BOTTOM-OF-SCREEN 


Comments:  "The  INFO  Window  Name?"  now  appears.  Now  request  information  o 

another  window. 

Command:  WINDOW_A  -  Request  ALL  information  on  WINDOW_A. 
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DISPLAY  ALL  INFORMATION  ON  WINDOW_A 

AIM  AIM  AIM  CLI  Running  More . .  AF 

Output  Pad  Name:  NONE 

Pad  Mode :  NONE 

Suspend  Output  on  Full  Window:  ON 
Suspend  Output  on  Switch-to-AIM:  ON 
Window  Output  Status:  ACTIVE 

Process:  FRCH:016 

Image  Associations: 

Image  Name  Top  Line  Viewport  Length 

MAIN  1  24 


Information  is  available  for: 

ASSOCIATIONS 

MODES 

PADS 

?ROCESS_STATUS 

INFO  Window  MAIN  Sub-block? 

INFO  Window  name?  WINDOW_A  { F4 } 

_  BOTTOM-OF- SCREEN 


Comments:  More  info 

Command:  {F4} 
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MORE  INFO 

AIM  AIM  AIM  CLI  Running  More . . 

Window  Name:  WINDOW_A 

Input  Pad  Name:  NONE 
Output  Pad  Name:  NONE 

Pad  Mode:  NONE 

Suspend  Output  on  Full  Window:  ON 
Suspend  Output  on  Switch-to-AIM:  ON 
Window  Output  Status:  ACTIVE 

Process:  FRCH:017 

Image  Associations: 

Image  Name  Top  Line  Viewport  Length 

IMAGE  11  8 


Infoimation  is  available  for: 

ASSOCIATIONS 

MODES 

PADS 

PROCESS_STATUS  { F4 } 

BOTTOM-OF-SCREEN 


Comments:  More  info 
Commands:  { F4 } 
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MORE  INFO 


AIM  AIM  AIM  CLI  Running  AF 

Input  Pad  Name:  NONE 
Output  Pad  Name:  NONE 

Pad  Mode :  NONE 

Suspend  Output  on  Full  Window:  ON 
Suspend  Output  on  Switch-to-AIM:  ON 
Window  Output  Status:  ACTIVE 

Process:  FRCH:017 

Image  Associations: 

Image  Name  Top  Line  Viewport  Length 

IMAGE  11  8 


Information  is  available  for: 

ASSOCIATIONS 

MODES 

PADS 

PROCESS_STATUS 

INFO  Window  WINDOW_A  Sub-block?  {return} 
_  _  BOTTOM-OF-SCREEN 


Comments:  ALL  the  information  for  the  window  WINDOW_A  is  displayed. 

Notice  that  the  text  is  naturally  broken  into  4  sub-blocks  of  information: 

1.  ASSOCIATIONS, 

2 .  MODES , 

3 .  PADS , 

4 .  PROCESS_STATUS , 

The  user  of  this  utility  can  display  any  one,  or  all  of  these  sub-blocks 
Command:  {return}  -  return  to  previous  INFO  level. 
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RETURN  TO  PREVIOUS  INFO  LEVEL 


AIM  AIM  AIM  CLI  Running  AF 

Output  Pad  Name:  NONE 

Pad  Mode :  NONE 

Suspend  Output  on  Full  Window:  ON 
Suspend  Output  on  Svitch-to-AIM:  ON 
Window  Output  Status:  ACTIVE 

Process:  FRCH:017 

Image  Associations: 

Image  Name  Top  Line  Viewport  Length 

IMAGE  1  1  8 


Information  is  available  for: 

ASSOCIATIONS 

MODES 

PADS 

PROC£SS_STATUS 

INFO  Window  WINDOW_A  Sub-block? 

INFO  Window  Name?  WIND0W_C  ASSOC 
_  BOTTOM-OF-SCREEN 


Comments:  The  "INFO  Window  Name?"  reappears  allowing  the  user  to  acquir 
information  for  another  window. 

Command:  WINDOW_C  ASSOC  -  "ASSOC"  uniquely  identifies  "ASSOCIATIONS" 
This  command  has  two  INFO  keywords,  "WINDOW_C"  and  "ASSOC".  It  wil 
display  ONLY  the  "ASSOCIATIONS"  for  the  window  WINDOW  C. 
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DISPLAY  ONLY  WINDOW  C'S  ASSOCIATION  INFORMATION 


AIM  AIM  Running  AF 

Image  Associations: 

Image  Name  Top  Line  Viewport  Length 

IMAGE  11  8 


Information  is  available  for: 

ASSOCIATIONS 

MODES 

PADS 

PROCESS_STATUS 

INFO  Window  WINDOW_A  Sub-block? 

INFO  Window  Name?  WINDOW_C  ASSOC 

Window  Name:  WINDOW_C 

Image  Associations: 

Image  Name  Top  Line  Viewport  Length 

IMAGE_1  17  8 

IMAGE_2  1  12 

INFO  Window  WINDOW_C  Sub-block?  MODSE 

BOTTOM-OF- SCREEN 


Comments:  ONLY  the  Image  associations  information  was  displayed  for 
WIND0W_C.  Since  there  are  other  sub-blocks  of  information  available  for 
the  window,  INFO  prompts  the  user  for  another  sub-block  name. 

Command:  MODSE  -  Invalid  INFO  keyword.  Should  have  been  "MODES". 
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EXIT  INFO  UTILITY 


AIM  AIM  AIM  CLI  Running  AF 

INFO  Window  WINDOW_A  Sub-block? 

INFO  Window  Name?  WINDOW_C  ASSOC 

Window  Name:  WINDOW_C 

Image  Associations: 

Image  Name  Top  Line  Viewport  Length 

IMAGE__1  17  8 

IMAGE_2  1  12 

INFO  Window  WIND0W_C  Sub-block?  MODSE 

Unrecognized  INFO  keyword,  MODSE. 

Information  is  available  for: 

ASSOCIATIONS 

MODES 

PADS 

PROCESS_STATUS 

INFO  Window  WINDOW_C  Sub-block?  { F10 } 

BOTTOM-OF-SCREEN 


Comments:  The  { FI 0 }  keystroke  command  exits  INFO  and  the  "AIM>"  promp 

reappears . 

Command:  {F10} 
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ENTER  EXIT  COMMAND 

AIM  AIM  AIM  CLI  Running  SF 

INFO  Window  WINDOW_A  Sub-block? 

INFO  Window  Name?  WINDOW_C  ASSOC 

Window  Name:  WINDOW_C 

Image  Associations: 

Image  Name  Top  Line  Viewport  Length 

IMAGE_1  17  8 

IMAGE_2  1  12 

INFO  Window  W I NDOW_C  Sub-block?  MODSE 

Unrecognized  INFO  keyword,  MODSE. 

Information  is  available  for: 

ASSOCIATIONS 

MODES 

PADS 

PROCESS_STATUS 

INFO  Window  WINDOW_C  Sub- block? 

AIM>  EXIT 

BOTTOM-OF-SCREEN 


Comments:  Enter  the  EXIT  command 

Command:  EXIT  -  Exit  the  AIM  program. 
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EXIT  THE  AIM 


INFO  Window  W I NDOW_A  Sub-block? 

INFO  Window  Name?  WINDOW_C  ASSOC 

Window  Name:  WINDOW_C 

i 

Image  Associations: 

Image  Name  Top  Line  viewport  Length 

IMAGE_1  17  8 

IMAGE_2  1  12 

INFO  Window  WINDOW_C  Sub-block?  MODSE 

Unrecognized  INFO  keyword,  MODSE. 

Information  is  available  for: 

ASSOCIATIONS 

MODES 

PADS 

PROCESS_STATUS 

INFO  Window  WINDOW_C  Sub-block? 

AIM>  EXIT 


BOTTOM-OF-SCREEN 


Comments:  The  AIM  has  terminated  its  execution  and  the  prompt 

underlying  APSE  reappears. 

Command:  None. 
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TERMINATE  EXECUTION  command,  4-98 

User  Defined  Script  Files,  5-13 

Vertical  partitioning,  3-2 


Viewport  header,  3-2  to  3-3  Windows,  3-2 

Viewports,  3-2 


DATE 

FILMED 

/4.S.A 


i«ru  command, 


Terminal  capau  i  1 1 1 1  ei  lijlc,  j-** 

TERMINATE  EXECUTION  command,  4-98 


Main  image,  3-4 

Main  window,  3-4  User  Defined  Script  Files,  5-13 

Mapped  onto,  3-2 

Mode  flags,  3-3  Vertical  partitioning,  3-2 
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